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What will you learn from this book? 

Let’s say you have an idea for a killer iPhone or iPad app. Where do 
you begin? Head First iPhone and iPad Development will help you get 
your first application up and running in no time. You’ll quickly learn 
to use iOS SDK tools, including Xcode 4, and master Objective-C 
programming principles that will make your app stand out. It’s a 
complete learning experience for creating eye-catching, top-selling 
iOS applications. 
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Why does this book look so different? 

We think your time is too valuable to waste struggling with new con¬ 
cepts. Using the latest research in cognitive science and learning 
theory to craft a multi-sensory learning experience, Head First iPhone 
and iPad Development uses a visually rich format designed for the way 
your brain works, not a text-heavy approach that puts you to sleep. 
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“ Head First iPhone and 
iPad Development 
brings a liumorous, 
engaging, and even 
enjoyable approach, to 
learning iOS develop¬ 
ment. With, coverage of 
key technologies includ¬ 
ing Core Data and even 
crucial aspects such, as 
interface design, the 
content is aptly chosen 
and top-notch.” 

— Sean Murphy ， 
iOS designer and developer 

“ Head First iPhone and 
iPad Development 
explains iOS application 
development from the 
ground up. The step-by- 
step approach with an 
emphasis on the visual 
makes this a great way 
to learn iPhone and 
iPad app development, 
from the basics to 
advanced features.” 

— Rich Rosen，software 
developer and co-author of 
Mac OS X for Unix Geeks 
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Advance Praise for Head First iPhone and iPad Development 


“Rather than textbook-style learning, Head First iPhone and iPad Development brings a humorous, engaging, 
and even enjoyable approach to learning iOS development. With coverage of key technologies including 
Gore Data and even crucial aspects such as interface design, the content is aptly chosen and top-notch. 
Where else could you witness a fireside chat between a UlWebView and UITextField?” 

— Sean Murphy, iOS designer and developer 


“Head First iPhone and iPad Development explains iOS application development from the ground up. Major 
enhancements to the first edition cover the changes associated with iOS 4, Xcode 4, and (re-)writing 
apps for use on the iPad. The step-by-step approach with an emphasis on the visual makes this a great 
way to learn iPhone and iPad app development, from the basics to advanced features.” 

— Rich Rosen，software developer and co-author of Mac OS Xfor Unix Geeks 


“The great thing about this book is its simple, step-by-step approach. It doesn’t try to teach everything — it 
just launches you right into building iOS applications in a friendly, conversational way. It’s a fantastic 
book for people who already know how to write code and just want to get straight into the meat of 
building iOS applications.’’ 


— Eric Shephard, owner of Syndicomm 


“Head First iPhone and iPad Development was clearly crafted to get you easily creating, using, and learning 
iOS technologies without needing a lot of background with Macintosh development tools.’’ 

— Joe Heck, Seattle Xcoders founder 


“This book is infuriating! Some of us had to suffer and learn iOS development ‘the hard way，’ and we’re 
bitter that the jig is up.” 

— Mike Morrison, Stalefish Labs founder 


“Head First iPhone and iPad Development continues the growing tradition of taking complex technical subjects 
and increasing their accessibility without reducing the depth and scope of the content. iOS development 
is a steep learning curve to climb by any measure, but with Head First iPhone and iPad Development, that 
curve is accompanied with pre-rigged ropes, a harness, and an experienced guide! I recommend this 
book for anyone who needs to rapidly improve their understanding of developing for this challenging 
and exciting platform.” 

— Chris Pelsor, snogboggin.com 



Praise for other Head First books 


“Head First Object- Oriented Analysis and Design is a refreshing look at subject of OOAD. What sets this book 
apart is its focus on learning. The authors have made the content of OOAD accessible, usable for the 
practitioner.” 

— Ivar Jacobson, Ivar Jacobson Consulting 


“I just finished reading HF OOA&D and I loved it! The thing I liked most about this book was its focus 
on why we do OOA&D — to write great software!” 

— Kyle Brown, Distinguished Engineer, IBM 

“Hidden behind the funny pictures and crazy fonts is a serious, intelligent, extremely well-crafted 
presentation of OO Analysis and Design. As I read the book, I felt like I was looking over the shoulder 
of an expert designer who was explaining to me what issues were important at each step, and why.” 

— Edward Sciore, Associate Professor, Computer Science Department, 

Boston College 


“All in all, Head First Software Development is a great resource for anyone wanting to formalise their 
programming skills in a way that constantly engages the reader on many different levels.” 

— Andy Hudson, Linux Format 


“If you’re a new software developer, Head First Software Development will get you started off on the right foot. 
And if you’re an experienced (read: long-time) developer, don’t be so quick to dismiss this...” 

— Thomas Duff ， Du£fbert ? s Random Musings 


“There’s something in Head First Java for everyone. Visual learners, kinesthetic learners, everyone can 
learn from this book. Visual aids make things easier to remember, and the book is written in a very 
accessible style — very different from most Java manuals.. .Head First Java is a valuable book. I can see the 
Head First books used in the classroom, whether in high schools or adult ed classes. And I will definitely 
be referring back to this book, and referring others to it as well.” 

— Warren Kelly ， Blogcritics.org, March 2006 



Praise for other Head First books 


“Another nice thing about Head First Java, 2nd Edition is that it whets the appetite for more. With later 
coverage of more advanced topics such as Swing and RMI，you just can’t wait to dive into those APIs 
and code that flawless, 100000-line program onjava.net that will bring you fame and venture-capital 
fortune. There’s also a great deal of material, and even some best practices, on networking and threads — 
my own weak spot. In this case, I couldn’t help but crack up a little when the authors use a 1950s 
telephone operator — yeah, you got it, that lady with a beehive hairdo that manually hooks in patch 
lines — as an analogy for TCP/IP ports...you really should go to the bookstore and thumb through Head 
First Java, 2nd Edition. Even if you already know Java, you may pick up a thing or two. And if not, just 
thumbing through the pages is a great deal of fun.” 

— Robert Eckstein ， Java.sun.com，April 2005 

“Of course it’s not the range of material that makes Head First Java stand out, it’s the style and approach. 
This book is about as far removed from a computer science textbook or technical manual as you can get. 
The use of cartoons, quizzes, fridge magnets (yep, fridge magnets...). And, in place of the usual kind of 
reader exercises, you are asked to pretend to be the compiler and compile the code, or perhaps to piece 
some code together by filling in the blanks or., .you get the picture. The first edition of this book was one 
of our recommended titles for those new to Java and objects. This new edition doesn’t disappoint and 
rightfully steps into the shoes of its predecessor. If you are one of those people who falls asleep with a 
traditional computer book then this one is likely to keep you awake and learning.” 

— TechBookReport.com，June 2005 


“Head First Web Design is your ticket to mastering all of these complex topics, and understanding what’s 
really going on in the world of web design...If you have not been baptized by fire in using something as 
involved as Dreamweaver, then this book will be a great way to learn good web design. ’’ 


— Robert Pritchett ， MacCompanion, April 2009 Issue 


“Is it possible to learn real web design from a book format? Head First Web Design is the key to designing 
user-friendly sites, from customer requirements to hand-drawn storyboards to online sites that work 
well. What sets this apart from other 4 how to build a web site’ books is that it uses the latest research 
in cognitive science and learning to provide a visual learning experience rich in images and designed 
for how the brain works and learns best. The result is a powerful tribute to web design basics that any 
general-interest computer library will find an important key to success.” 

— Diane C. Donovan, California Bookwatch: The Computer Shelf 


“I definitely recommend Head First Web Design to all of my fellow programmers who want to get a grip on 
the more artistic side of the business. ，’ 


— Claron Twitchell, UJUG 
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Your brain on iOS Development. Here you are trying to learn 

something, while here your brain is doing you a favor by making sure the learning 
doesn't stick. Your brain's thinking, "Better leave room for more important things, 
like which wild animals to avoid and whether naked snowboarding is a bad idea.” 
So how do you trick your brain into thinking that your life depends on knowing 
enough to develop your own iPhone and iPad apps? 
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Going Mobile with iOS 

The iPhone changed everything. 

The iPhone 4 “changed everything, again.” And now you’ve got the iPad to 
contend with, too. iOS devices are now capable word processors, e-readers, 


and video cameras. They are being used in business and medicine as 
enterprise devices and the App Store is a platform for every developer to use, 
from one-man shows to big name companies. Apple provides the software 
and we’ll help you with the knowledge; we’re sure you’ve got the enthusiasm 




covered. 

So, you want to build an iOS app... 
...’cause everyone wants one! 

Apps live in an iTunes universe 
Time to make a decision 




It all starts with the iPhone SDK 
Take a look around 

Xcode includes app templates to help you get started 

Xcode is a full-featured IDE 

Xcode is the hub of your iOS project 

Build your interface within Xcode 

Add the button to your view 

The iOS simulator lets you test your app on your Mac 
iDecide’s logic 
Changing the button text 

You’re using the Model View Controller pattern 
iDecide is actually a little simpler 
What happened? 

Use the GUI editor to connect UI controls to code 
A component can trigger certain events 
Connect your events to methods 
You’ve built your first iPhone app! 

Your iOS Toolbox 
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!05 app pcttterns 

Hello, Renee! 

Apps have a lot of moving parts. 

OK, actually, they don’t have any real moving parts, but they do have lots of Ul 
controls. Atypical iPhone app has more going on than just a button, and now it’s time 
to build one. Working with some of the more complicated widgets means you’ll need 
to pay more attention than ever to how you design your app as well. In this chapter, 
you’ll learn how to put together a bigger application and some of the fundamental 
design patterns used in the iOS SDK. 
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objectiVe-c IOS 

mail needs variety 

e did a lot in Chapter 2, but what language was that? 


Parts of the code you’ve been writing might look familiar, but it’s time you got a sense 
what’s really going on under the hood. The iOS SDK comes with great tools that 


mean you don’t need to write code for everything, but you can’t really write apps 
without learning something about the underlying language, including properties, 


message passing, and memory management. Unless you work that out, all your apps 
will be just default widgets! And you want more than just widgets, right? 
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Renee is catching on... 

Make room for custom input 

Header files describe the interface to your class 

Auto-generated accessors also handle memory management 

To keep your memory straight, you need to remember just two things 

But when Mike’s finished typing... 

Customize your UITextField 

Components that use the keyboard ask it to appear... 

Ask the UITextField to give up focus 
Messages in Objective-G use named arguments 

Use message passing to tell our View Controller when the Done button is pressed 
Where’s the custom note? 

Your Objective-G Toolbox 
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multiple VieWs 

A table with a view 

Most iOS apps have more than one View. 

We’ve written a cool app with one view, but anyone who’s used a smartphone knows 
that most apps aren’t like that. Some of the more impressive iOS apps out there do 
a great job of working with complex information by using multiple views. We’re going 


to start with navigation controllers and table views, like the kind you see in your Mail 


and Contact apps. Only we’re going to do it with a twist... 






So, how do these views fit together? 145 

The navigation template pulls multiple views together 146 

The table view is built in 147 

A table is a collection of cells 152 

Just a few more drinks... 160 

Plists are an easy way to save and load data 162 

Arrays (and more) have built-in support for plists 165 
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Xcode supports you after your app breaks, too 190 
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plfsts and modal Views 

efining your app 


you have this almost-working app... 

That’s the story of every app! You get some functionality working, decide to add 
something else, need to do some refactoring, and respond to some feedback from the 


App Store. Developing an app isn’t always ever a linear process, but there’s a lot to be 
learned along the way. 
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It all started with Sam... 198 

Use the debugger to investigate the crash 200 
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We have a usability problem 213 
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We need a view...but not necessarily a new view 228 

The View Controller defines the behavior for the view 229 

A nib file contains the UI components and connections... 230 
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Modal views focus the user on the task at hand... 236 
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Everyone’s an editor... 

Displaying data is nice, but adding and editing information is 
what makes an app really hum. 

DrinkMixer is great ― it uses some cell customization, and works with plist dictionaries to 
display data. It’s a handy reference application, and you’ve got a good start on adding new 
drinks. Now, it’s time to give the user the ability to modify the data —— saving, editing, and 
sorting — to make it more useful for everyone. In this chapter, well take a look at editing 


patterns in iOS apps and how to guide users with the Nav Controller. 



Sam is ready to add a Red-Headed School Girl... 

...but the keyboard is in the way 

Wrap your content in a scroll view 

The scroll view is the same size as the screen 

The keyboard changes the visible area 

iOS notifies you about the keyboard 

Register with the default notification center for events 

Keyboard events tell you the keyboard state and size 

The table view doesn’t know its data has changed 

The array is out of order, too 

Table views have built-in support for editing and deleting 
Your iOS Development Toolbox 
Sam has another project in mind... 
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e need more room 


hones are great, but a bigger screen can be better. 

hen the iPad first launched, some panned it by saying that it was “just a big iPhone” 
(but uh, without the phone). In many ways it is, but that screen opens up many 
opportunities for better user interaction. More screen real estate means that reading is 
comfortable, web pages are easily viewed, and the device can act more like a book. Or 
a calendar. Or many other things that you already know how to use, like a menu... 


DrinkMixer on the iPad 

The iPad simulator 

The HIG covers iPads, too 

Use Xcode to build your Universal app 

Check your devices 

Rotation is key with iPad 

A persistent view problem 

Don’t forget the tableview 

Your iOS Development Toolbox 
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tab bars and core delta 



Enterprise apps 

Enterprise apps mean managing more data in different ways. 

Companies large and small are a significant market for iPhone and iPad apps. A small 
handheld device with a custom app can be huge for companies that have staff on the 
go. Most of these apps are going to manage lots of data, and since iOS 3.0, there has 


been built-in Core Data support. Working with that and another new controller, the tab bar 
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controller, we’re going to build an app for justice! 
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Controller 





HF bounty hunting 

A new iPhone control 

Choose a template to start iBountyHunter 

There’s a different structure for universal apps 

Drawing how iBountyHunter iPhone works... 

...and how it fits with the universal app 
Build the fugitive list view 
Next up: the Captured view 
A view’s contents are actually subviews 
After a quick meeting with Bob... 

Core Data lets you focus on your app 

Core Data needs to know what to load 

Core Data describes entities with a Managed Object Model 

Build your Fugitive entity 

Use an NSFetchRequest to describe your search 

Bob’s database is a resource 

Back to the Core Data stack 

The template sets things up for a SQLite DB 

iOS Apps are read-only 

The iPhone’s application structure defines 
where you can read and write 

Copy the database to the Documents directory 

Your Core Data Toolbox 
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migrating and optfmfang with core dstta 



Things are changing 

We have a great app in the works. 

iBountyHunter successfully loads the data Bob needs and lets him view the fugitives easily. 
But what about when the data has to change? Bob wants some new functionality, and what 


does that do to the data model? In this chapter, you’ll learn how to handle changes to your 
data model and how to take advantage of more Core Data features. 
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Bob needs documentation 
Everything stems from our object model 
The data hasn’t been updated 
Data migration is a common problem 
Migrate the old data into the new model 
Xcode makes it easy to version your data model 
Core Data can “lightly” migrate data 
Here’s what you’ve done so far... 

Bob has some design input 
Your app has a lifecycle all its own... 

Multitasking rules of engagement 

A quick demo with Bob 

Use predicates for filtering data 

We need to set a predicate on our NSFetchRequest 

Core Data controller classes provide efficient results handling 

Time for some high-efficiency streamlining 

Create the new FetchedResultsGontroller getter method 

We need to refresh the data 

Your Data Toolbox 
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Proof in the real world 

iOS devices know where they are and what they see. 

As any iPhone, iPod Touch, or iPad user knows, these devices go way beyond just 
managing data: they can also take pictures, figure out your location, and put that 
information together for use in your app. The beauty about incorporating these 



features is that just by tapping into the tools that iOS gives you, suddenly you can 
import pictures, locations, and maps without much coding at all. 
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IFad UI 

Natural interfaces 

The iPad is all about existing in the real world. 

We’ve built a basic iPad port of an existing app for DrinkMixer a few chapters 
back, but now it’s time to build an interface that works with some real-world 
knowledge. By mimicking things that people use in the real world, users know 
what to do with an interface just by opening the app. We’re going to use some 
real-world elements to help Bob catch the bad guys... 
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appendix h leftovers 

The top 4 things (we didn’t cover) 

Ever feel like something’s missing? We know what 
you mean... 

Just when you thought you were done, there’s more. We couldn’t leave you 
without a few extra details, things we just couldn’t fit into the rest of the book. 
At least, not if you want to be able to carry this book around without a metallic 
case with castor wheels on the bottom. So take a peek and see what you 
(still) might be missing out on. 
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#2. View animations 606 
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appendix % preparing an app for distribution 

參 # Get ready for the App Store 

You want to get your app in the App Store, right? 

So far, we’ve basically worked with apps in the simulator, which is fine. But to get 
things to the next level, you’ll need to install an app on an actual iPhone, iPad, or 
iPod Touch before applying to get it in the App Store. And the only way to do that is to 
register with Apple as a developer. Even then, it’s not just a matter of clicking a button 
in Xcode to get an app you wrote on your personal device. To do that, it’s time to talk 
with Apple. 



Apple has rules 

The Provisioning Profile pulls it all together 
Keep track in the Organizer 
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how to use this book 


Who is this book for? 


If you can answer “yes” to all of these: 


① 

② 


Do you have previous development experience? 

Do you want to learn, understand, remember, and 
apply important iOS design and development concepts 
so that you can write your own iPhone and iPad apps 
and start selling them in the App Store? 


y I 七 dc-Pmi-tcly helps you've 
/ already 90-t some obj^-t-ov-ichtcd 

^oys, -too. with 

^ “P 略七 is hclp-ful, but 
dc+ihi-tcly ho-t 


(3) Do you prefer stimulating dinner party conversation 
to dry, dull, academic lectures? 


this book is for you. 


Who should probably back away from this book? 

If you can answer “yes” to any of these: Che 匕 k out Head Fwsi J ava J( ov . a 

cx^cllch-t ih-tirodu^-tioh -to objed- 

(?) Are you completely new to software development? . ov-ic^tcd dcvdopmch-t, av\d -thch 

^ ba ^ k 枷 d jom us iphohcvillc. 

© Are you already developing iOS apps and looking for a 
reference book on Objective-C? 


^3) Are you afraid to try something different? Would 
you rather have a root canal than mix stripes with 
plaid? Do you believe that a technical book can’t be 
serious if there’s a bounty hunter in it? 

this book is not for you. 


C ^ oic ^ -this book is 
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the intro 


Wc know what you're thmkmg. 

“How can this be a serious iOS development book?” 
“What’s with all the graphics?” 


“Can I actually learn it this way?” 

And we know what yourAra/fiis thmkmg. 







Your brain craves novelty. It’s always searching, scanning, waiting for 
something unusual. It was built that way, and it helps you stay alive. 


How does your brain know what’s important? Suppose you’re out for 
a day hike and a tiger jumps in front of you. What happens inside your 
head and body? 


So what does your brain do with all the routine, ordinary, normal things 
you encounter? Everything it can to stop them from interfering with 
the brain’s real]oh — recording things that matter. It doesn’t bother 
saving the boring things; they never make it past the “this is obviously 
not important” filter. 


And that’s how your brain knows... 


Great. Only 
640 more dull, 
dry, boring pages. 


Neurons fire. Emotions crank up. Chemicals surge. 


This must be important! Don’t forget it! 

But imagine you’re at home, or in a library. It’s a safe, warm, tiger-free 
zone. You’re studying. Getting ready for an exam. Or trying to learn 
some tough technical topic your boss thinks will take a week, 10 days 
at the most. 

Just one problem. Your brain’s trying to do you a big favor. It’s trying 
to make sure that this obviously non-important content doesn’t clutter 
up scarce resources. Resources that are better spent storing the really 
big things. Like tigers. Like the danger of fire. Like how you should 
never again snowboard in shorts. 

And there’s no simple way to tell your brain, “Hey brain, thank you 
very much, but no matter how dull this book is, and how little I’m 
registering on the emotional Richter scale right now, I really do want 
you to keep this stuff around.” 
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latest research in cognitive scie , know what turns your brain on. 
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Head First learning principles: 
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page, and 

problems related to the content. 
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import the 
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Metacognition: thinking about thinking 


If you really want to learn, and you want to learn more quickly and more deeply, 
pay attention to how you pay attention. Think about how you think. Learn how you 
learn. 

Most of us did not take courses on metacognition or learning theory when we were 
growing up. We were expected to learn, but rarely taught to learn. 


I wonder how I 
can trick my brain 
into remembering 
this stuff... 



So just how DO you get your brain to think that 
iOS development is a hungry tiger? 


There’s the slow, tedious way, or the faster, more effective way. The 
slow way is about sheer repetition. You obviously know that you 


are able to learn and remember even the dullest of topics if you 
keep pounding the same thing into your brain. With enough repetition, your 
brain says, “This doesn’t feel important to him, but he keeps looking at the same thing over 
and over and over, so I suppose it must be.” 


But we assume that if you’re holding this book, you really want to learn about iOS 
development. And you probably don’t want to spend a lot of time. And since you’re 
going to build more apps in the future, you need to remember what you read. And 
for that, you’ve got to understand it. To get the most from this book, or any book or 
learning experience, take responsibility for your brain. Your brain on this content. 


The trick is to get your brain to see the new material you’re learning 
as Really Important. Crucial to your well-being. As important as a 
tiger. Otherwise, you’re in for a constant battle, with your brain doing 
its best to keep the new content from sticking. 


The faster way is to do anything that increases brain activity, especially different 
types of brain activity. The things on the previous page are a big part of the solution, 
and they’re all things that have been proven to help your brain work in your favor. For 
example, studies show that putting words within the pictures they describe (as opposed to 
somewhere else on the page, like a caption or in the body text) causes your brain to try 
to makes sense of how the words and picture relate, and this causes more neurons to fire. 
More neurons firing = more chances for your brain to get that this is something worth 
paying attention to, and possibly recording. 


A conversational style helps because people tend to pay more attention when they 
perceive that they’re in a conversation, since they’re expected to follow along and hold up 
their end. The amazing thing is, your brain doesn’t necessarily care that the “conversation” 
is between you and a book! On the other hand, if the writing style is formal and dry, your 
brain perceives it the same way you experience being lectured to while sitting in a roomful 
of passive attendees. No need to stay awake. 


But pictures and conversational style are just the beginning. 
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Here's what WE did: 


We used pictures^ because your brain is tuned for visuals, not text. As far as your brain’s 
concerned, a picture really is worth a thousand words. And where text and pictures work 
together, we embedded the text in the pictures because your brain works more effectively 
when the text is within the thing the text refers to, as opposed to in a caption or buried in the 
text somewhere. 

We used redundancy, saying the same thing in different ways and with different media types, 
and multiple senses, to increase the chance that the content gets coded into more than one area 
of your brain. 

We used concepts and pictures in unexpected ways because your brain is tuned for novelty, 
and we used pictures and ideas with at least some emotional content, because your brain 
is tuned to pay attention to the biochemistry of emotions. That which causes you to feel 
something is more likely to be remembered, even if that feeling is nothing more than a little 

humor, surprise, or interest. 



We used a personalized, conversational style, because your brain is tuned to pay more 
attention when it believes you’re in a conversation than if it thinks you’re passively listening 
to a presentation. Your brain does this even when you’re reading. 

We included loads of activities, because your brain is tuned to learn and remember more 
when you do things than when you read about things. And we made the exercises challenging- 
yet-do-able, because that’s what most people prefer. 



BULLET POINTS 


We used multiple learning styles, because might prefer step-by-step procedures, while 
someone else wants to understand the big picture first, and someone else just wants to see 
an example. But regardless of your own learning preference, everyone benefits from seeing the 
same content represented in multiple ways. 

We include content for both sides of your brain, because the more of your brain you 
engage, the more likely you are to learn and remember, and the longer you can stay focused. 
Since working one side of the brain often means giving the other side a chance to rest, you 
can be more productive at learning for a longer period of time. 


Fireside Chats 



And we included stories and exercises that present more than one point of view, 
because your brain is tuned to learn more deeply when it’s forced to make evaluations and 
judgments. 

We included challenges, with exercises, and asked questions that don’t always have a 
straight answer, because your brain is tuned to learn and remember when it has to work at 
something. Think about it — you can’t get your body in shape just by watching people at the 
gym. But we did our best to make sure that when you’re working hard, it’s on the right things. 

you 9 re not spending one extra dendrite processing a hard-to-understand example, 
or parsing difficult, jargon-laden, or overly terse text. 



We used people. In stories, examples, pictures, etc., because, well, a person. And your 
brain pays more attention to people than it does to things. 
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Here's what YOU caw do to bend 
your bram into submission 

So, we did our part. The rest is up to you. These tips are a 
starting point; listen to your brain and figure out what works 
for you and what doesn’t. Try new things. 

Cui ihis sii^k a 

° h y° uir 


Slow down. The more you understand, 
the less you have to memorize. 

Don’t just read. Stop and think. When the 
book asks you a question, don’t just skip to the 
answer. Imagine that someone really is asking 
the question. The more deeply you force your 
brain to think, the better chance you have of 
learning and remembering. 

(g) Do the exercises. Write your own notes. 

We put them in, but if we did them for you, 
that would be like having someone else do 
your workouts for you. And don’t just look at 
the exercises. Use a pencil. There’s plenty of 
evidence that physical activity while learning 
can increase the learning. 

(3) Read the “There Are No Dumb Questions” 
sections. 

That means all of them. They’re not optional 
sidebars — they } re part of the core content! 

Don’t skip them. 

(4) Make this the last thing you read before 
bed. Or at least the last challenging thing. 

Part of the learning (especially the transfer to 
long-term memory) happens after you put the 
book down. Your brain needs time on its own, to 
do more processing. If you put in something new 
during that processing time, some of what you 
just learned will be lost. 

( 5 ^ Drink water. Lots of it. 

Your brain works best in a nice bath of fluid. 
Dehydration (which can happen before you ever 
feel thirsty) decreases cognitive function. 


Talk about it. Out loud. 

Speaking activates a different part of the brain. 

If you’re trying to understand something, or 
increase your chance of remembering it later, say 
it out loud. Better still, try to explain it out loud 
to someone else. You’ll learn more quickly, and 
you might uncover ideas you didn’t know were 
there when you were reading about it. 

( 7 ^ Listen to your brain. 

Pay attention to whether your brain is getting 
overloaded. If you find yourself starting to skim 
the surface or forget what you just read, it’s time 
for a break. Once you go past a certain point, you 
won’t learn faster by trying to shove more in, and 
you might even hurt the process. 

( 8 ) Feel something! 

Your brain needs to know that this matters. Get 
involved with the stories. Make up your own 
captions for the photos. Groaning over a bad joke 
is still better than feeling nothing at all. 

( 9 ^ Create something! 

Apply this to your daily work; use what you’re 
learning to make decisions on your projects. Just 
do something to get some experience beyond the 
exercises and activities in this book. All you need 
is a pencil and a problem to solve … a problem that 
might benefit from using the tools and techniques 
you’re studying for the exam. 
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Read me 

This is a learning experience, not a reference book. We deliberately stripped out everything 
that might get in the way of learning whatever it is we’re working on at that point in the 
book. And the first time through, you need to begin at the beginning, because the book 
makes assumptions about what you’ve already seen and learned. 


We start off by building an app in the very first chapter. 

Believe it or not, even if you’ve never developed for iOS before, you can jump right in 
and starting building apps. You’ll also learn your way around the tools used for iOS 
development. 


We don’t worry about preparing your app to submit to the App 
Store until the end of book. 

In this book, you can get on with the business of learning how to create iOS apps without 
stressing over the packaging and distribution of your app out of the gate. But we know 
that’s what everyone who wants to build an iOS app ultimately wants to do, so we cover 
that process (and all its glorious gotchas) in an Appendix at the end. 


We focus on what you can build and test on the simulator. 

The iOS SDK comes with a great (and free!) tool for testing your apps on your computer. 
The simulator lets you try out your code without having to worry about getting it in the 
app store or on a real device. But, it also has its limits. There’s some cool iOS stuff you just 
can’t test on the simulator, like the accelerometer and compass. So, we don’t cover those 
kinds of things in very much detail in this book since we want to make sure you’re creating 
and testing apps quickly and easily. 


The activities are NOT optional. 

The exercises and activities are not add-ons — they’re part of the core content of the book. 
Some of them are to help with memory, some are for understanding, and some will help 
you apply what you’ve learned. Don } t skip the exercises. Even crossword puzzles are 
important — they’ll help get concepts into your brain so they stay there when you’re coding. 
But more importantly, they’re good for giving your brain a chance to think about the words 
and terms you’ve been learning in a different context. 
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The redundancy is intentional and important. 


One distinct difference in a Head First book is that we want you to really get it. And we 
want you to finish the book remembering what you’ve learned. Most reference books 
don’t have retention and recall as a goal, but this book is about learning, so you’ll see 
some of the same concepts come up more than once. 


The Brain Power exercises don’t have answers. 


For some of them, there is no right answer, and for others, part of the learning 
experience of the Brain Power activities is for you to decide if and when your answers 
are right. In some of the Brain Power exercises, you will find hints to point you in the 
right direction. 

System requirements 

To develop for the iPhone and iPad, you need an Intel-based Mac, period. We wrote 
this book using Snow Leopard and Xcode 4.0. If you’re running Leopard with an older 
version of Xcode, we tried to point out where there were places that would trip you up. 
For some of the more advanced capabilities, like the accelerometer and the camera, 
you’ll need an actual iPhone, iPod Touch, or iPad and to be a registered developer. In 
Chapter 1, we tell you where to get the SDK and Apple documentation, so don’t worry 
about that for now. 


the review team 


The technical review team 




Rich Rosen is one of the co-authors of Mac OS Xfor Unix Geeks. He also collaborated with Leon Shklar on Web 
Application Architecture: Principles, Protocols & Practices, a textbook on advanced web application development. He began 
his career eons ago at Bell Labs, where his work with relational databases, Unix, and the Internet prepared him well for 
the world of web technology. He lives in New Jersey with his wife, Celia, whose singing provides a sweet counterpoint to 
the cacophony he produces in his Mac-based home recording studio. 


Sean Murphy has been a Cocoa aficionado for almost 10 years, contributes to open source projects such as Gamino, 
and works as an independent iOS designer and developer. He lives in Pennsylvania with his best friends — a fiancee, 
horses, dogs, and cats — and seriously loves hiking, hockey, and nature. 


Joe Heck is a software developer, technology manager, author, and instructor who’s been involved with computing for 25 
years and developing for the iPhone platform since the first beta release. He’s the founder of the Seattle Xcoders developer 
group, which supports Macintosh and iPhone development in the Seattle area, and the author of SeattleBus, an iPhone 
app that provides real-time arrival and departure times of Seattle public transportation (available on the App Store). 

Eric Shepherd got started programming at age nine and never looked back. He’s been a technical writer, writing 
developer documentation since 1997, and is currently the developer documentation lead at Mozilla. In his spare time, 
he writes software for old Apple II computers — because his day job just isn’t geeky enough — and spends time with his 
daughter. His thorough review means that no one else has to go through the problems he had in actually making the 
code work. 

Michael Morrison is a writer, developer, and author of Head First JavaScript, Head First PHP & MySQL, and even a 
few books that don’t have squiggly arrows, stick figures, and magnets. Michael is the founder of Stalefish Labs {www 
.stalefishlabs. com\ an edutainment company specializing in games, toys, and interactive media, including a few iPhone 
apps. Michael spends a lot of time wearing helmets, be it for skateboarding, hockey, or iPhone debugging. Since he has 
iPhone Head First experience, Mike was a great resource to have helping us. 
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1 getting started 

♦Going Mobile with iOS ♦ 



The iPhone changed everything. 

The iPhone 4 “changed everything, again.” And now you’ve got the iPad to contend with, 
too. iOS devices are now capable word processors, e-readers, and video cameras. They 
are being used in business and medicine as enterprise devices, and the App Store is a 
platform for every developer to use, from one-man shows to big-name companies. Apple 
provides the software and we’ll help you with the knowledge — we’re sure you’ve got the 
enthusiasm covered. 


this is a new chapter 







let’s get started 


So, you wawt to build an iOS app … 

Maybe you use an iPhone all the time and wish “it could do that.” Maybe you 
have an app you love that could be so much better. You might have a business 
that wants to leverage computing power that fits in your customers’ hands. Or 
perhaps you have an idea for an app that could start a business. There are a lot 
of motivations to want to code for iPhone and iPad, and lots of customers, too. 



2 Chapter 1 








going mobile with iOS 


../cause Gvcryowc wants owe! 

There’s a big market out there for iPhone and iPad developers. iOS apps are rapidly 
becoming advertising tools that non-tech businesses want to use, like websites. 
Enterprises are starting to use iPhones, iPads, and iPod Touches for employees to 
perform work that they once did with a clipboard or even a laptop. 

But while there’s a lot of opportunity, there’s also plenty for you to learn, even as 
an experienced OO developer. Most companies are choosing to outsource iOS 
development work, making it a great opportunity for freelancers, too. 


Just look at the app store 

At the time this book went to print, there 
were over 500,000 different apps available 
for download from the App Store. More 
than that, the percentage of apps for sale 
that are games has held steady, while the 
gross number of apps continues to rise. 

That means that the number of apps for 
sale that allow users to perform a task is 
going up; people are integrating mobile 
computing into their lives for more than 
just playing. 





sTtu Wfiil 


f |B SUrlw# 

Cl W-«i*r 4 *€ 

铨， -ep-fcrtrt 


» * 


crame poach 

fiqm?Lr 與 hffl 咖 woln 如 


Df«rlions: 






Cafgi Meow 


Cupid's OocWail 


Day at the Beach 


foer Hunier 


Fiirccrockcr 


NfrrsS 


Gi^gerbfMd Mart 


Let’ s start witk kow 
an app gets from your 

Iteact to a device 參參參 


you are here ► 


3 














the lifecycle of an app 


Apps live m an itunes universe 


To get an app approved, sold, distributed, or installed, you need to work 
with the Apple iOS SDK before getting your app into the iTunes App 
Store. Here’s a quick picture of the cycle of which you’re going to be a part. 
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Code and 
test it in 
Xcode. 


After a sync, its 
live on the device! 


Use iTunes 
Connect for 
the approval 
process. 
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going mobile with iOS 


Time to make a decision 

You’re probably brimming with app ideas, but for this first one, we’re going to start simple. 
Our first application is pretty straightforward: it is going to be a single view with a button 
that the user can push to make a decision. For now we’ll build this just for iPhone; we’ll get 
into iPads a bit later in the book. 

When users start up your application, the first thing they see is a view. It’s essentially 
the user interface, and it needs to be easy to use and focused on what your application is 
supposed to do. Throughout this book, whenever we start a new application, we’re going to 
take a little time to sketch up what we want our views to look like. 
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starting with the SDK 


It all starts with the iOS SPK 

Head over to http:/ / developer.apple.com/ios. You can download the SDK (and 
other useful Apple development resources) for free with the basic registration — 
but to distribute a completed app in the App Store or install your app on an 
iPhone, iPod Touch, or iPad for testing, you’ll need to become a paid Standard or 
Enterprise Developer. The basic registration provides the SDK with a simulator 
for testing directly on your Mac, so you can go the free route for now to get 
started. 



孝 Wwnii ft 




Register as a developer at 
http:/ / developer, apple, com / ios. 


Download the latest SDK; 
this book is based on the 
4.3 SDK. Just look for the 
Download button at the 
top of the page. 


Install the SDK. Once the Installation completes, you can 
find Xcode.app in /Developer/Applications. 
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going mobile with iOS 


Take a look around 


Navigate over to the install directory, which is /Developer/Applications by 
default. If your installation went right, the install directory should have a few 
key things. 



Applications 


Search 


Action 

—=Audio 
Da.shcode,app 
Graphics Tools 

® instruments.app 
— Performance Tools 
f Quartz Composerapp> 
CD Utilities 
i Xcode.app 


PasV^todc used 

dasV^boavdi Widyb a 扒 d 

Y\oi iOS lA/c 
be 七 W ,s . 


I^s-b'ruwcyrbs V^cl^s Ssscss 
mCwov-Y 

duvm^ -bestrn^. 


《 udv 七： ComfOSCV " £> 3 ^ be 

used *to tveate motion 

-fov youv app. But 
•tliaVs -fov a^o*t^cv- book. 


X 匕 ode is 七 he IDE used "to 
wv-i-tc the Objcdiivc-C -fov- 
you\r iOS appkaiion av\d jus 七 
jot a rwajov- overhaul v/i-th 
)< 匕 ode 午 . 1/VlcVc jomg -feo yt 
*to k^ow ii vcally well. 



The iPhone Simulator (installed in /Developer/Platforms/ 
iPhoneSimulator.platform/Developer/Applications/iPhoneSimulator. 
App) lets you run iOS in a simulated device on your Mac for simplified 
app testing while you’re writing code. We’ll be firing this up shortly, too. 


Now tkat you kave every tiring installect, go akeact 
and ctoutle-click on Xcode to get it started. 


you are here ► 















jumpstart things with templates 


Xcode includes app templates to help 
you get started 


When you start Xcode, you’ll get a welcome screen where you can select 
Create a New Project. Each project is a collection of files (a.k.a. a template) 
that have some info and code already populated based on the type of project. 


TV^csc art kasit 
templates. Based on youv 

todc and 

avc set up ^o\r you. 


Choose a template for your new project: 


T^is is i\\t vc^Y 
same )<^odc 仏 a 七 
youd use *bo develop 
foV 七 V\C Ma 乙 . S'lir\6C 

y/cVc v/ovk»y>5 

七 V^c iP^oy\c, wake 

su\TC lOS 
is seized.. 



$ V ou tkk 。以 aA ?呼气七把 

iU , 心 V^rc WifUcbphU 


仏 c dcsM ? 七 

you oy\ sow»c (Ac*b3“ s ’ 


As we go through the book, we’ll use different types of projects and discuss why you’d 
choose one over another for each app. For iDecide, we have just one screen (or view), so 
start with the View-based Application and give it the Product Name iDecide. Leave 
the Device Family as iPhone and uncheck the box for Include Unit Tests. In the 
final dialog box, uncheck the box for Create Local Git Repository. 


8 Chapter 1 




























going mobile with iOS 


Xcode is a full-featured 1PE 

Xcode is much more than just a text editor. As you’ve already seen, Xcode includes templates 
to get you started developing an application. Depending on your application, you may use all 
of a template or just parts of it, but you’ll almost always start with one of them. Once you get 
your basic app template in place, you’ll use Xcode for a lot more: 


Maintaining your project resources 

Xcode will create a new directory for your project and sort the various 
files into subdirectories. You don’t have to stick with the default layout, 
but if you decide to reorganize, do it from within Xcode. Xcode also has 
built-in support for version control tools like Git and Subversion and can 
be used to check out and commit your project changes. 


Editing your code and resources 

You’ll use Xcode to edit your application code, and it supports a variety 
of languages beyond just Objective-G. Xcode also has a number of 
built-in editors for resource files like plists and xib and nib files (we’ll 
talk more about these later on). For resources Xcode doesn’t handle 
natively, double-clicking on one of those files in Xcode will launch the 
appropriate editor. Some file types Xcode can only view, like pictures, or 
it will merely list, like sound files. 




Building and testing your application 

Xcode comes with all of the compilers necessary to build your code 
and generate a working application. Once your application is compiled, 
Xcode can install it on the iOS Simulator or a real device. Xcode 
includes LLVM and GDB debuggers with both graphical and command¬ 
line interfaces to let you debug your application. You can also launch 
profiling tools like Instruments to check for memory or performance 
issues. 




Prepare your application for sale 

Once you get your application thoroughly tested and you’re ready to 
sell it, Xcode manages your provisioning profiles and code signing 
certificates that let you put your application on real devices or upload it 
to the iTunes App Store for sale. We’ve got more info on this process in 
the Appendix. 


► Turn tire pa^e to see A^iat Xcode looks like. 


you are here ► 
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use Xcode for everything 


Xcode is the hub of your iOS project 

When Xcode opens your new View-based project, it is populated with 
all of the files that you see here, but we’ve changed the view a bit. By 
expanding the project and selecting a .xib file (which is your view, 
more on that in a minute), the GUI editor is open on the left. To open 
the side-by-side assistant view, click the Assistant Editor button on the 
upper right of the editor. 

d ‘ all — 

class -Pi| cs ihai ^ 

^ well the .xib 

pics -tha-t will r^akc up ihc 
+o\r youv- app. 

Evcvy dlass has a M (headev) 
m -file *to 

W\{\\ it. They v/ovk •tojctiicv- *to 

6\rca*tc dlass. 




Hcv-C IS Y/V\cv-c You tar\ t0Y\^\py* 
诜 c 七 "to Wild vou^r w 
i\st s'iwula-bo'r or a \rcal device. 
lAfe’ll s-b'itk y/*rtv^ W\t sWulaxov- 
七 Wro—ou 七七 V^C book. 



mdrn 
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o 从伏 data 妊 a 七 '/ 雜矸？ w,IUccd 


七 0 矿叫 
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iDeitJe 
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MilnW1nd€rw,Mib 
Ih. IDicideViCiMZi>nir<ollcr.h 

tU iDcuJeVievfC<(iiiiAiijllei .m 

iiT^i n fyj.d. irT<r<i i' 


u Supporting Hits 

iDfdde-Info.iillSii 
lnfDPfiU“rH|ik 
[ll] inrcidip -Pr#-fiic.pfli 
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Foundation. trarrKi^ork 
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going mobile with iOS 


TV»c WW 

心二 ' r“?f ab r 


This 


tu*t*toh ^h^hjcs you 浐 

view-to show the Assis^ht 


iDecide ^ iDecideVifSwC'QntrolEer.Kib 


^ci... iDeci^^itwConCrailier.xib 


b |Cr>glish|i 


View ]!JJ ||| iDccidieViifiviCDrvlTiiillc'f.h No Selection 

77 " 

if sllf-ridr-Vi-notrn-llr-r, h 
H iDc^ide 

// 

if Created Uy Tracts Pilonc sn 2/9/11- 
// Cgpyr iqht 2611 HyCifHpdn^iNjnc ■ All 

n 


IdjHBjOI □!□![!] 
— — 


□ 


kijliis 


swerved. 


Z- 


*LmpoTi cUIKil/UIKil,fi' 

'Jintertate lP«cltit¥lFMCant roller : UIVitwCflrnr&L ifcf 
1 


眘 end 


These bu^btems d\re dll used bo 
split up "the view "fco show -the 
dcbugjcv-, vcv-sioi^s, d 


TV^c hs\sia^i td'i-tov- 
auWat^allv sclents elated 
uAt disflays \i V^c. The 

v, C y, Co^broWtr U IW.S V.cy/ 
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We’ll be using some of the other tools 
that came with the SDK (especially the 
Simulator), but they are all working with 
the files that are included here. 


The files and frameworks shown were 
stubbed out based on our selection of a 
View-based application. As we go forward, 
we’ll use different types of apps, and that 
will lead to different defaults. 

For our app, the template includes 
iDecideViewG ontroller.h and 
iDecideViewG ontroller.m. Every 
Objective-G class in the template has both 
a header (.h) and an implementation 
(.m) file. When the app is compiled, they 
work together to create a class. We’ll dive 
into the view controller shortly. 



B 形 


Frameworks are what libraries are called in Objective-C. 
UIKit, CoreGraphics, and Foundation are loaded by default, 
but we’ll show you how to add more later. 


you are here ► 
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Xcode up close 


)(c^ie files Tip Cl®S' 



卜！ 


ulator 


If you take a closer look at the 
files that were generated by Xcode, 
you’ll see iDecideViewController.h 
and iDecideViewGontroller.m, as 
well as iDecideAppDelegate.h and 
iDecideAppDelegate.m. Those .h and 
•m pairs work together to create a class. 

You’ll also see the 
iDecideViewGontroller.xib file. It 
creates the first view for the app. 



OK, so I have an idea about how 
Xcode is organized. But what about 
the views? What are those .xib files 
anyway, and do I work with them in 
XCode, too? 


Sort 


-the GUI editor in XCode handles 


■xib files. 

Those .xib files (also called “nibs”）are XML documents that are 
loaded by the Cocoa Touch framework when the app starts up. 
We’ll talk a lot more about this in the next chapter, but for now it’s 
just important to understand that the GUI editor in XGode (often 
also called Interface Builder) is not creating Objective-G code. It’s 
creating an XML description of the GUI you’re building, and the 
Cocoa Touch framework uses that to actually create the buttons 
and whatnot for your application at runtime. Everything we do in 
Interface Builder could be done in pure Objective-G code, but as 
you’ll see, there are some things that are really just easier to lay out 
with a GUI builder. 
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going mobile with iOS 




Da this! 


To edit the view files in Xcode, you'll need to open up the .xib file and 
change some settings in the workspace. 


O Highlight the iDecideViewController.xib file 


❺ Close the Assistant Editor by clicking this 
button. 

O^ly ^c^cssav-y i-P you opened i*t cav-licv- -to see 
*thc edrtov-. Well use i-t mov-c latcv-, but v/cVc 
*thc 6{\A\ -fov- nov/. 

❺ Show the library by opening the Utilities 
Pane, here. 


A n o 

( ■ [ |jD^cid( I iflhnne 4.?. Simnliitnr ‘ 



if 

n & A 迓 P 

IH> 

▼ 

IDec^c 

-J 1 咖并 . .OS 543^4.2 




d decide 

h h 

jh ； IDcddeAppDei«gjE^m 
MjiiriWiridciw.?iib 
h infrdrlirVar'ME nntmllN.h 
[m\ IDetidcVitMCDrviirollcir.m 

,__I Supporting FiF«x 

InfA.filitt 

InfaPH&c.sTrlngs; 



O 


B, 


1 a □ 

D 

□ s 考•命 o 



▼ Identity 


lilt Hi 

irru Ar%trAll#r vih 



FSt 1 

vp« 、 DefaftiH - com.jpplc.lnc. 

T) 


o 

o 


Show the Objects Library for the views 
by clicking on this button. 


Adjust the size of the library by dragging 
this bar up. 



you are here ► 
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interface building 

Puild your interface within Xcode 

When you open up any .xib file in Xcode, the GUI editor will be launched in the main 
window. With the view tweaking you just finished on the previous page, Xcode will be 
ready to work with the views. Now it shows an overview of items in your nib, your view, 
and a library of UI elements (on the right). You can drag and drop any of the basic library 
elements into your view, edit them, and work with the connections between the code and 
these elements, using the assistant editor. All of these elements come from the Cocoa Touch 
framework, a custom UI framework for iOS devices. 


」 iDecide - iDecideViewController.xib 


iDecide I iPhone 4.2 Si. 


M]b1 


n ® ^ ee ： 


m 


2S!I ◄ 卜 」 [[ iDecide ► f [iDecide ^ iDeci... > p iDecideViewController.xib (English) > View 


D □ S 


舻 O 


l iDecide 

]1 target. iOS SDK 4.2 
Cl\ iDecide 

h iDecideAppDelegate.h 
[mj iDecideAppDelegate.m 
/v MainWindow.xib 
h iDecideViewController.h 
[mj iDecideViewController.m 


▼ Supporting Files 

iDecide-Info.plist 
InfoPlist.strings 
! _hj iDecide-Prefix.pch ^ 

! m| main.m / IlC S Ov/ 

_j Frameworks 

UIKit.framework 
Foundation.framework 


►夤 CoreCraphics.framework 
CZ\ Products 




o 




UcM s 7 祕 

slate tW»s. As 70U 

add UI 

sec ^11 

look “ us 广 m 

从 aUecds 吟 ^ ) 

m Vou “十严 

vlCN ,s usmoy toAt 十 ’饮 


▼ Identity 


File Name iDecideViewController.xib 


File Type ' Default - com.apple.... i 


Location Relative to Croup 


en.lproj/ 

iDecideViewController.xib 

Full Path /Users/Tracey/Desktop/ 
iDecide/iDecide/ 
en.lproj/ 

iDecideViewController.xi 
b O 


D U ^ ■ 


Objects 


3 


I Label - A variably sized amount of 

LaD ®l static text. 


Round Rect Button - Intercepts 
touch events and sends an action 
message to a target object when... 


Segmented Control - Displays 
2 multiple segments, each of which 
functions as a discrete button. 


TKc libvav-y sV>ov/s all elements you 
choose -Pv-om bo dv-of m*fco youv v*ic>w. |-P you sCroW 


000 © 





abound，you 11 see 1 







Text Field - Displays editable text 
Text and sends an action message to a 

target object when Return is tapped. 

Slider - Displays a continuous range 
of values and allows the selection of 
a single value. 


Switch - Displays an element 
showing the boolean state of a value. 
Allows tapping the control to... 

Activity Indicator View - Provides 
feedback on the progress of a task or 
process of unknown duration. 


Progress View - Depicts the 




Tliis section siiov/s objects and v/iev/s 3v*c 
d-uyvcyrtly ^edied -fov 七 V>a 七 pavtidulav r>ib- Pile s Ovmev 
and Fivs-t Rcsfondcv- e>cist "fov cvcvy y>ib, ar\d 
othevs will vavy. I/Vcll talk about bo*tV> *m ^t\\ gveatev- 
detail latcv. 
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going mobile with iOS 


Add the button to your view 

To add elements, all you need to do is drag and drop the 
elements you want onto your view. For our app, we just need a 
button with text that can be changed. 



Drag the 

rectangular button 
onto the view. 

The initial size of the 
button will be small, 
so resize it to be a bit 
bigger. Just grab the 
corners of the button 
and pull. 


move the text around 
to center it on the 


button. 




Drag a label onto 
the button. 

Edit the new label 


on the button to say 
“What should I do?” 


by double-clicking on 
the label and typing 
the new text. Then 


Slider - Displays a continuous range 
of values and allows the selection of 
a single value. 


Switch - Displays an element 
showing the boolean state of a value. 
Allows tapping the control to... 


_ iDecide - iDecideViewController.xib 


Label 


A variably sized amount of 


Label 


static text. 


Round Rect Button - Interc^p 
touch events and sends an act 各 
message to a target object when 


Segmented Control - Displays 
multiple segments, each of which 
functions as a discrete button. 




A* iDecideViewController.xib (English) > No Selection 


▼ Identity 


File Name iDecideViewController.xib 


File Type Default - com,apple.... ) i ) 


en.lproj/ 

iDecideViewController.xib 


Full Path /Users/Tracey/Desktop/ 
iDecide/iDecide/ 
en.lproj/ 

iDecideViewController.xi 

b 


Q3I Objects 


Activity Indicator View - Provides 
feedback on the progress of a task or 
process of unknown duration. 


Progress View - Depicts the 


■目 


〖Decide Qji. i. 


Location Relative to Group 


Text 


Text Field - Displays editable text 
and sends an action message to a 
target object when Return is tapped. 


What should I do? 
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test drive 




TesT DriVq 


Now, save your work. To build the file, make 
sure that the scheme selected is the “iPhone 4.x 
Simulator,” then press the Build and Run button 
here. 



® ▼④ 


iDecide I iPhone 4.2 Simulator 



H n Q A EE 


m 


I L/C 


I iDecide 

1 target. iOS SDK 4.2 
PH iDecide 

iDecideAppDelegate.h 
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going mobile with iOS 


The iOS simulator lets you test your 
app on your Mac 


The Simulator is a great tool for testing your apps quickly and for free. It 
doesn’t come with all the applications that a real device does, but for the most 
part, it behaves the same way. When you first start the simulator, you see the 
springboard — just like on a real iPhone (it’s the initial screen that shows 
all your app icons) — with iDecide installed (and a default icon that you can 
change later). Xcode then opens the app and your code is running. 


There are some differences between using the Simulator and your iPhone. For 
starters, shaking and rotating your Mac won’t accomplish anything, so those 
don’t work in the Simulator. To approximate rotation and check landscape 
and portrait views, there are some commands under the Hardware 
menu. You also have limited gesture support, GPU and memory usage 
don’t represent reality, and hardware capabilities like tilt sensors (or the 
accelerometer or gyroscope) don’t exist at all. 


Even with these issues, testing on the simulator is just so much quicker and 
easier than a real device that you’ll find you use it for major portions of your 
development. You can always start with the Simulator and then move to a 
real device as your application (or hardware needs) mature. 



The Simulator has limitations. 

Memory, performance, camera, GPS, and 
other characteristics cannot be reliably 
tested using the Simulator. We’ll talk more 
about these later, but memory usage and 
performance are tough to test on the simulator simply 
because your Mac has so many more resources than the 
iPhone or iPad. To test these things, you need to install 
on an actual device (which means joining one of the paid 
development programs). 


/ou doh i have {o do anyth— 

f ial io the SimulaW 

oi ^ 桄如 build ah d vuh vouv 

岬卜 1 




So, you protatly want to pusk 
tkis button rigfkt now anct see 
wkat kappens, rigkt? Go alieacL. 
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understanding iDecide 


OK, so the button exists, but it doesiVt 
do anything. It needs a little code, right? 



Ul behavior is implemented in Objective-C. 

Interface Builder creates your button, but to make that button actually 
do something, you’ll need to write some code that tells the button how to 
behave. 

Controls — which are the UI elements like the button you just added — 


trigger events when things happen to them, like the button being pressed. 
For events like button presses, Interface Builder can connect the view 
controls with code in your controller class for action methods, tagged 
with IBAction (for Interface Builder Action). We’ll talk more about the 
Objective-C syntax for actions a bit later, but for now, you’ll need to 
declare a method in your header (.h) file and implement it in the .m. 


iPecide's logic 


Any controls you create need a method that 
Interface Builder can use to connect the control 
to behaviors specified in the implementation file. 


bu'»ldcv-. 





iDecideViewController.xib 



Button 


Voull V.kclv all 4 

七 po〆 七 sv/ca 七夂 at ^ 

m a bit- 


m 





TWls lTu e 

一 


-(IBAction) 
buttonPressed:(id) 
sender; 




-(IBAction) 
buttonPressed : (id) 
sender 


do buttony kinds of 
things 



iDecideViewController.h 



y ou provide He method 

70 U 

6odc U? “a 七 should 

adtuallv ⑼ ^ 

七 k «s jessed- 


iDecideViewController.m 
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going mobile with iOS 


Changing the button text 

You know that the button is going to need an IBAction to respond to the button press 
and that we write up what the button should do in the implementation file. But just what 
is it that the button should do? 

We want to change the text in the button to provide an answer. So that means we need 
some way to reach back “out” to the interface and change the label text. We’ll use an 
IBOutlet to do that. 



- (IBAction) buttonPressed : 

T 1 C a ^ ioh ^pohds -to the 

-to ki,k U, 

… the Code. 3 


code ^ov.dcs a flatc ^ \d -to 
^'ive us a *to label so wc 

it 


IBOutlet UILabel *decisionText; 


(id)sender; 


o 


We’ll get into actions and outlets more later. 

IBActions and IB Outlets are both key for understanding 
how to work with controls, and we’ll go into a lot 
more detail on both in the next chapter. For now, just 
remember that actions are used to react to events in the interface, and outlets 
are used to reach out from the code to change the interface. 



you are here ► 
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no dumb questions 


What happens if I don’t implement 
everything in the .h file? 

At compile time, Xcode will complain. 
It’s going to check that you fully implemented 
the class you declared in the corresponding 
header file. Since that’s not the case, 
you’ll start with a warning telling you that 
happened. If you need that code to support 
anything else, then it’ll crash at runtime. 

What exactly are frameworks? Are 
they the same thing as libraries? 

They’re really similar. They include 
shared, compiled code like libraries, but 
they also can bundle in images, headers, 
documentation, etc. 

Do I have to use Interface Builder 
to build my views? 

No. You can do everything you can 
do in Interface Builder in code (and then 
some). However, using Interface Builder 
doesn’t mean you can’t do things in code, 
too. Since Interface Builder gives you a nice, 
graphical way of laying out your views, most 
apps have at least some of their Ul built in 
Interface Builder then tweaked or animated 
in code. 

Do I have to write my application in 
Objective-C? 

Earlier releases of the iOS Developer 
Agreement required the use of Objective-C 
for any application that will be distributed 



through the iTunes App Store. Apple later 
relaxed that requirement, opening up the 
possibility of using other tools or languages. 
Having said that, nearly everything you’ll 
find about iOS development will make the 
assumption you’re using Objective-C. All 
the underlying frameworks are written in 
Objective-C (or written to work with it), the 
documentation and sample code uses it, 
and the tool suite is built around it. Basically, 
if you’re serious about writing native 
applications, you should learn Objective-C 
and start writing in that. 

Can I give applications I write out 
to friends? 

Yes and no. First, if you want to put 
an application on anyone’s actual device 
(including your own), you’ll need to register 
for the paid Apple iOS Developer program. 
Once you’ve done that, you can register up 
to 100 devices and install your application 
on them. However, that’s not really a great 
way to get your application out there, since 
Apple limits how many devices you can 
register this way. It's great for testing your 
application, but not how you want to go 
about passing it around. 

A better way is to submit your application 
to the iTunes App Store. You can choose 
to distribute your application for free or 
charge for it, but by distributing it through the 
iTunes App Store, you make your application 
available to the world (and maybe make 
some money, too!). We’ll talk more about 
distributing apps later in the book. 

Finally, there’s an Enterprise Developer 
program you can join that lets you distribute 


applications internally without using the App 
Store. This works, but is more expensive 
than the normal program. 

Do I have to use an IDE? I’m really a 
command-line kinda developer. 

Technically speaking, no, you don’t 
have to use the Xcode IDE for straight 
development. However, the IDE makes 
iOS development so much easier that you 
really should ask yourself if you have a 
good reason for avoiding it, especially since 
testing on an actual device or the simulator 
is so tightly coupled to Xcode. This book 
uses the Xcode IDE as well as other Apple 
development tools, and we encourage you 
to at least try them out before you abandon 
them. For things like automated builds or 
automated testing, the SDK comes with a 
command-line build tool called xcodebuild 
that can build your application just like 
Xcode does, but you’ll most likely still want 
to do your actual development in Xcode. 

Can I develop an app for the iPhone 
and then rebuild it for other phones like 
Windows Mobile or Android phones? 

In a word, no. When you develop for 
iPhone, you use Apple’s iOS frameworks, 
like Cocoa Touch, as well as Objective-C. 
Neither of these are available on other 
devices. 
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%|terpen your pencil 


Below is the code for when the button gets tapped. Add the bolded code to the 
iDecideViewController.h and iDecideViewController.m files. We are creating three 
things: the UlLabel property, the 旧 Action to respond to the button press, and the 
旧 Outlet to change the label when the button is pressed. 


#import <UIKit/UIKit•h> 

Qinterface iDecideViewController 

UlLabel *decisionText_; 

} 


UlViewController { 


\A/c bo label 

so y/c weed # lB0u*tlc*b to 

be able ^ labcl ， 

^\\\ W»ld OUV WD- 



©property (retain, nonatomic) IBOutlet UlLabel *decisionText; 


- (IBkction)buttonPressed : (id)sender; 

@end V Well talk mo^rc about 

fv-ofcv"*tics l3*tc\r m kook. 


tw 士 adW 滅 w,1 ' akt 

^ WtW«s jessed- 



iDecideViewController.h 


TV>c @sy^*tV>csiz^ -tells *tV>c 6om\>ilcv *to 

#import ''iDecideViewController. h" dvea-tc a ytW a^d stiitr -fov- i\\c 

@implementation iDecideViewController pvofCV-by >wC dttUrtd *m *tV>C header file. 

@synthesize decisionText=decisionText_; ^ ^>|| ㈣ ^ 如七 mor e m CMpW 

sende^TW»s »s aj 

> 栋 e WtWu ^ssed. 

decisionText_. text = @〃Go for it!; 

y\fe，U use ouv ^Cctr^U -to 

i\\t label *to tV\c 


- (IBAction)buttonPressed:(id) 


- (void)dealloc { 

[decisionText 一 release]; 

[super dealloc]; 



about tW»s m 气 W. 




iDecideViewController.m 


you are here ► 
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sharpen solution 


r. Sharpen vour pencil 



Here’s the code from before in the context of the full files for 
iDecideViewController.h and iDecideViewController.m. 


#import <UIKit/UIKit.h> 

Qinterface iDecideViewController 
UlViewController { 

UILabel *decisionText ; 


Qproperty (retain, nonatomic) 
IBOutlet UILabel *decisionText; 

- (IBAction)buttonPressed:(id) 
sender; 

@end 










iDecideViewController.h 


TW, 6 ode 

.,Ucadcr Vtstrt S a 

二 。 n 卞 

a,a 脉 w a 山 W 

oiav WlUabcl 


丁 he IBOuilei is a io 

^ label ihai wc 1l ihc 

oh the a h d ihe 

’嶋伽 whai will 

a ^ uall y ha PP^ whch the butU 
is passed. 


#import ''iDecideViewController . h” 

@implementation iDecideViewController 

@synthesize 

decisionText=decisionText_; 

- (IBAction)buttonPressed:(id) 
sender 


decisionText .text=@〃Go for it !〃； 



This is implcm Ch -tatioh todt. wcVc 

d^ihihg the method that is U\td whch the 
UU is passed. W, use a to^i 

^ I 如 I. 

dcd.s.ohTcxt is a ircWhdc io the U/Labcl 

wc ⑽ a*ted ih /htc\rfadc Builds. 




- (void)dealloc { 

[decisionText 一 release]; 

[super dealloc]; 


iDecideViewControlk r.m 






Tk — 丄 一 V IV 

uses ^ 

丄 V 一 a— k ab :“ 

-fv-CC "bV>C wemOV-Y* 
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going mobile with iOS 


You're using the Model View Controller pattern 

Model View Controller (MVG) is a pattern that is discussed at length in Head First Design 
Patterns. You see it used a lot with GUI applications, and it’s all over the Cocoa Touch 
framework. The short version is that as much as possible, you want to separate out your 
logic from your view and data. It’s especially key when you want to write one set of logic 
to support both iPhone and iPad UIs, which we’ll do later in the book. 


l/icw 


初 W 似卜 Npp 




Model 





Co^ollcr 



_ vour user V/.11 

Wt •» 七 己枷 be WiM … 已 ode, ° 






Does our implementation of iDecide differ from 
MVC? If so, how? 


6oy\*tvo\s m savcs ar\d 

^ -^s 卞巧二“如 

sttr\ so 
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iOS development secrets 


iPecide is actually a little simpler 

For iDecide，we don’t have a datasource we’re dealing with — there’s 
nothing to store since we’re just changing the text label and can specify 
that in one line in iD e cide Vie wG on trailer, m. So iDecide is simplified to 
more of a View - View Controller pattern. You can think of it like the 
MVG pattern without an M — we don’t need a model here. 




广 l/i 〜 Co^ollc^r is associated with 




s AtsM m a ^ 

itrUt dMtr. ne W'atc 
ramev/ovk v/c used loads 
h a 七 starts 


This pattern is the secret to iOS development 

- - 

If you only have room in your brain for one thing from this chapter, this is what should fill 
that space: the Model-View-Controller pattern and the View-ViewController 
pattern are really just specific examples of a general Delegation pattern 
used everywhere in iOS development. Something delegates responsibility out to 
another class that’s responsible for actually performing an action as a result. In this case, 
the view needs to delegate out to the Vie wG ontroller (through UI events) and let the 
Vie wG ontroller know that something happened. 

The Vie wG ontroller (or delegate) then picks up the responsibility of reacting to that event 
and doing whatever the app has to do next. Sometimes setting up delegates is an explicit 
thing where you actually tell an object what its delegate is. Sometimes it’s a little more 
indirect and you do it by linking controls up to methods, like Interface Builder does. 
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going mobile with iOS 



TesT DriVq 


You've got your 旧 Action and 旧 Outlets set up, so build and run the code again. Try 
clicking on the button in the simulator and see if it works. 






Why didn’t the button change? Who’s not doing 
their job? 


you are here ► 
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hooking up 


What happened? 

The Objective-G that we wrote is all set to handle things when the button is 
pressed, but the view hasn’t been set up to connect the button to that code. 
We need to use the GUI editor to hook up our button to the buttonPressed 
method we just wrote. Then when the .xib file is loaded by the framework, 
it will connect the button object it creates with our code. 


tw»s 



iDecideViewController.xib 


Button 




do buttony things 






斤 is the p 扣 t W 代 r^issiha— the lihk 


the Code 


- (IBAction) 
buttonPressed:(id) 
sender; 



- (IBAction) 
buttonPressed:(id) 
sender 


iDecideViewController.h 



iDecideViewController.m 


Unless thcUI components arc hooked up to the code, 
nothing is going to happen. 

We need to connect the button’s u Hey, I just got pressed’’ event to our 
buttonPressed action method. That will get our method called when the 
user taps on the button. We then need to get a reference to the UILabel 
that the framework is going to create for us when the nib is loaded — that’s 
where the IBOutlet comes in. Let’s start with the outlet so we can change 
the UILabel text when the button is pressed. 
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going mobile with iOS 


Use the frUl editor to connect Ul controls to code 

Highlight iDecideViewGontroller.xib to bring up the GUI editor, and open the Assistant 
Editor so you can see iDecideViewGontroller.h alongside. Now let’s hook up the button to 
our new code. 


_ iDecide - iDecideViewController.xib 


CD 


t.2 Simulator 




EIb Ql 


4 


iDe... > Q > ■ > ■ > I — View > Label - What should I do? 


V 


v 






□ 



h] iDecideViewCo … ) B ©interface iDecideViewController | Q □ 

77 

// iDecideViewController.h 
// iDecide 
// 

// Created by Tracey Pilone on 2/9/11. 

// Copyright 2011 _ MyCompanyName _• All rights 
reserved. 

// 

#import <UIKit/UIKit.h> 

@interface iDecideViewController : UlViewController { 
UILabel ^decisionText 一； 


( retain, nonatomic) IBOutlet UILabel 
decisionText; 

( IBAction) buttonPre^ed: ( id) sender; 


TWis Will 

W 吵 1 吵七 cd. 


o 

❺ 


^ — 1 ( you 
(just ho 


doh t have a two-but-toh mouse ； 

Id CTRL a^d thch dlidk. 


Right-click on the label you dropped on the 
button. This will bring up a list of events and 
references. 


Click on the circle next to New Referencing 
Outlet and drag it to the @property statement 
for the Outlet in the .h file on the right. Now 
when the decisionText UILabel is generated, our 
decisionText property will reference the control, 
through the IBOutlet. 


OK—I get how we 
can now change the 
label, but how does 
the GUI know that 
you pressed a button? 
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handy little lists 


A component caw trigger certain events 


We need to attach the right component event to our code. Remember that action method 
you wrote earlier that you can connect the button to? 


- （工 BAction) 

I 好二 \v\itr 
Bu»ldicv* 




byttonPressed : (id)sender; 



f\W ⑽出⑽ wCSS . a ^ s 

咖。 ': 二 “ 

av ^CV>t. t 

ml— 


4 二::二 e 3以“ 一恤 atW 


Now we need to pick the event that should trigger this method. If you right-click 
on the button in the editor, you’ll see a list of events it could dispatch. We want the 
TouchUpInside event. 


a\\ o( 


TW 、 S 二八咖 - 

\}\t book. 


▼ 

Button 

Sent Events 

Did End On Exit 

O 


Editing Changed 

o 


Editing Did Begin 

o 


Editing Did Bd 

o 


Touch Caned 

o 


Touch Down 

o 


Touch Down R-epeat 

o 


Touch Drag Eiftter 

o 


Touch Drag Exil 

o 


Touch Drag Inside 

o 


Touch Drag Outside 於 



o 


Touch Up Outside 

o 


Valu« Changed 

o 

▼ 

Referencing Outlets 

New R^fer^nding Outlet 

o 

▼ 

Referencing Outlet Collections 

New Rfifer^nding Oudet Col lection 

o 

L Al 





be us'm^ i\\t Toudii 
Uf Inside everrt. 


Components dispatch events when things happen to them 

Whenever something happens to a component — for instance, a button gets tapped — the 
component dispatches one or more events. What we need to do is tell the button to notify 
us when that event gets raised. We’ll be using the TouchUpInside event. If you think 
about how you click a button on an iPhone or iPad, the actual click inside the button isn’t 
what matters: it’s when you remove your finger (or “touch up”）that the actual tap occurs. 
Connecting an event to a method is just like connecting an element to an outlet, which 
you just did on the previous page. 
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Connect your events to methods 

Just like with outlets, you drag the connection from the button event to 
the - (IBAction) code in iDecideViewGontroller.h and select the action 
that should be called. 


Q] iDecide - iDecideViewController.xib 



► | (J iDecide > QjiDe... H iDe... > iDe... 」View 」 Button 


I M ^ I h| iDecideViewCo... > Q (^interface iDecideViewController | Q 




% 


0 


SB 

r 

What 

Hi 

■ 



// 

// iDecideViewController.h 
// iDecide 
// 

// 

// 


V 


Created by Tracey Pilone on 2/9/11. 

Copyright 2011 — MyCompanyName — . All rights 
reserved. 


// 


#import <UIKit/UIKit.h> 

@interface iDecideViewController : UlViewController 
UILabel ♦decisionText : 


@property ( retain, nonatomic) IBOutlet UILabel ♦ 
decisionText; 


IBAction) button^ressed : (id)send^^ 



Right-click on the button 
you dragged onto the view. 
This will bring up a list of 
events and references, like 
it did with the label. 





TesT DriVq 


Then click on the circle next to Touch Up Inside 
and drag it to the IBAction in the .h file. Now 
when the button gets pressed, our buttonPressed 
method will be called. 


Now that everything is hooked up, it's ready to run. Make sure you save everything and 
then build and run. 


you are here ► 
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test drive 




TesT DriVq 



6jd a message Keve! 



Clitk iicvc! 


It works! 
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going mobile with iOS 


You've built your first iPhone app! 

All the pieces are fitting together: 




The nibs (*.xib) describe the interface. 

iDecide is made up of two nibs: the MainWindow.xib and our 
iDecideViewGontroller.xib. Together, these describe the UI the user sees. 




The views are connected to the code in the View Controller. 

Our views are connected to the implementation code through Interface 
Builder using IBOutlets and IBActions. IBOutlets give us references to UI 
components, and IBActions are called when events happen. 



Our application behavior is implemented in our View Controller. 

Following the MVG pattern (or really, just the VC pattern), we have all of 
our behavior implemented in our View Controller, cleanly separated from 
the view itself. The View Controller uses IBOutlets to get back to our actual 
UI controls if it needs to update them. 


BULLET POINTS - 

■ Interface Builder creates nib files (with a 
.xib extension) that describe the GUI in 
XML 

■ Nib files are loaded by the Cocoa Touch 
framework and are turned into real 
instances of Cocoa Touch classes at 
runtime. 

■ In order to connect the components 
described in a nib to your code, you use 
IBOutlets and IBActions. 


■ Xcode is where your code and files are 
maintained for your application. 

■ Xcode is the hub for your project 
development and offers support for editing 
your code, building your application, and 
debugging it once it’s running. 

■ The iPhone Simulator lets you test your 
application on your Mac without needing a 
real device. 


you are here ► 
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no dumb questions 


What is that File’s Owner thing? 

Interface Builder has an expectation 
of what class will be the nib’s File’s Owner. 
You can change what class Interface Builder 
thinks it will be, but by default, a new project 
is set up so that the main View Controller 
created by Xcode is the File’s Owner for 
the main view created by Xcode. That’s 
why we didn’t have to change anything. 

Since the File’s Owner is set up to be our 
iDecideViewController, Interface Builder 
looks at the iDecideViewController header 
and sees that we have an 旧 Outlet named 
descriptionText and an 旧 Action named 
buttonPressed. When you connected 
the UlLabel’s referencing outlet to File’s 
Owner descriptionText, Interface Builder 
saved the information necessary so that 
when the nib is loaded by the application, 
the references are set correctly in our 
iDecideViewController. The same thing 
happened with the Touchllplnside event, 
except in this case, instead of hooking up 
a component to a reference, it hooked up a 
component’s event to a method that should 
be called. 

Beware—Interface Builder's expectation of 
the class that will load the nib does not mean 
that other classes can’t try—it just might 
not work well if that class doesn’t have the 
necessary properties and methods. 

Why does our new text string have 
an @ in front of it? 

The Cocoa Touch framework uses 
a string class named NSString for its text 


there^ctre no ^ 

Dumb Questi9ns 


strings. Since it’s so common, Objective-C 
has built-in support for creating them from 
constants. You indicate a string constant 
should be an NSString by putting an @ 
symbol in front of it. Otherwise, it’s just a 
normal char* like in C or C++. 

How much of what we’ve covered 
is iPhone-specific? Is developing for the 
iPod Touch or iPad very different? 

Not at all! One of the benefits of 
developing for iOS is that most things built 
for one iOS device can be used directly on 
another iOS device. You'll need to be careful 
about device-specific hardware capabilities 
(for example, trying to use a camera on an 
older iPod Touch or iPad won’t work), and 
the screen resolution of your views and 
images will need to change, but otherwise, 
developing for different devices is largely 
hidden from you. 

If you keep the MVC pattern in mind and 
make sure to separate logic from views, it’s 
much easier to add new views for other 
devices to your app. 

How does Xcode actually build an 
application? 

We're going to get into this more in 
the coming pages. The short version is that 
Xcode can gather up all your resources and 
code, link them together, and then spit out a 
nice package at the end that drops into the 
sandbox available on the iOS device. 

Why do I keep hearing about 
Interface Builder? What is that really? 


Before, Xcode 4 views were edited in a 
separate application called Interface Builder. 
Now it’s a part of XCode and isn’t really 
called Interface Builder any more. Since this 
transition is still new, folks may still be working 
in and talking about IB. 

When the views are compiled, 
why do they stay .xib files? Shouldn’t 
something change? 

After compilation, the .xib files are 
actually .nib files in their binary form. 

What exactly are these 
“undocumented APIs” I keep hearing 
about? 

譬 

• These are private methods that Apple 
gets to use, but you don’t. An example 
is multitasking. It just became available 
for developer use with iOS 4, but some of 
Apple’s applications have been able to run 
in the background from the beginning (for 
example, the iPod application doesn’t stop 
playing when you switch to another app). 

You typically see developers touching 
undocumented, private methods when 
trying to customize a standard iOS control 
or change what a physical button does. 

Don’t do this. Apple will catch it during the 
approval process and they will reject your 
application for it. Protecting these APIs is 
part of Apple protecting the platform, and 
what is undocumented now may be allowed 
in the future. 
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备 O 办鼇 ‘ ^MATT-? 


Match each iOS development item to its description. 


Item 


Description 


IBOutlet 


Functions of Xcode 


The Model View Controller pattern 
where the view delegates behavior to 
a controller. 


Xcode, Instruments, Interface Builder, 
and the iOS Simulator. 


MVC 


Reference from the code to an object 
in the nib. 


IBAction 


Images, databases, the icon file, etc. 


Components of the SDK 


Application resources 


Maintaining and editing code and 
resources, debugging code, and 
preparing an app for deployment. 


Indicates a method that can be called 
in response to an event. 


you are here ► 
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who does what solution 















Match each iPhone development item to its description. 


Item 


工 BOutlet 


Functions of Xcode 


MVC 


工 BAction 


Components of the SDK 


Application resources 


Description 



The Model View Controller pattern 
where the view delegates behavior to 
a controller. 


Xcode, Instruments, Interface Builder, 
and the iPhone Simulator. 


Reference from the code to an object 
in the nib. 


Images, databases, the icon file, etc. 


Maintaining and editing code and 
resources, debugging code, and 
preparing an app for deployment. 


Indicates a method that can be called 
in response to an event. 
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aa] Plizzjc 


Your job is to take filenames from the 
pool and place them into the blank 
lines pointing to the diagram. You 
may not use the same filename 
more than once, and you won’t 
need to use all the names. Your 
goal is to make a complete 
diagram that will show the design 
of iDecide. 


外 P 4 s “仏 







Delegate 




Note: each thing from 
the pool can only be 
used once! 
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pool puzzle solution 



Paa] puzzjc 

Your job is to take filenames from the 
pool and place them into the blank 
lines pointing to the diagram. You 
may not use the same filename 
more than once, and you won’t 
need to use all the names. Your 
goal is to make a complete 
diagram that will show the design 
of iDecide. 


"Thcirc ish *t Ohc -foV" 

this 岬卜 Wc\\ have ohc 
,ihC 佺此 that s i h 
•Dc^idcl/icwCohiirollcv.m, 

buU。cxtcirhal datasouv^dcs. 




iDec|deyi_ewControMer.xib 

MainWindow.xib 





Thc ^ icw us ^ sees is made 

^ihlVihdow.xib wi*th 

^^idcl/icwCo^ollev.xib 

embedded ih ii 


iDecideViewController.m 


iDecideViewController.h 


Note: each thing from 
the pool can only be 
used once! 
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10§ CPaSS 

Bend your brain around some of the new 
terminology we used in this chapter. 



Down 

1. The language used to write iPhone apps. 

2. This is used on a desktop to test an app. 

3. This is used to recieve an event in code and trigger 
something. 

6. This is the name of the editor used for Objective-C. 
9. The iPhone is this kind of device. 

11. The name of a file used to create a view. 

13. These are used in Xcode to provide classes to be accessed. 


Across 

4. Something that the simulator cannot reliably test. 

5. This is used to set up an outgoing connection from the 
implementation code to the view. 

7. The term to describe each screen of an iPhone app. 

8. The framework used to write iPhone apps. 

10. The folder used to organize the images for the app. 
12. The name of the IDE for iPhone apps. 
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/OS cross solution 



10^ cmss 

Bend your brain around some of the new 
terminology we used in this chapter. 



Across 

4. Something that the simulator cannot reliably test. 
[PERFORMANCE] 

5. This is used to set up an outgoing connection from the 
implementation code to the view. [ 旧 OUTLET] 

7. The term to describe each screen of an iPhone app. [VIEW] 

8. The framework used to write iPhone apps. [COCOATOUCH] 
10. The folder used to organize the images for the app. 

[RESOURCES] 

12. The name of the IDE for iPhone apps. 
[INTERFACEBUILDER] 

13. These are used in Xcode to provide classes to be accessed. 
[FRAMEWORKS] 


Down 

1. The language used to write iPhone apps. [OBJECTIVEC] 

2. This is used on a desktop to test an app. [SIMULATOR] 

3. This is used to recieve an event in code and trigger 
something. [ 旧 ACTION] 

6. This is the name of the editor used for Objective-C. 
[XCODE] 

9. The iPhone is this kind of device. [MOBILE] 

11. The name of a file used to create a view. [NIB] 
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going mobile with iOS 



Your iOS Toolbox 

You’ve got Chapter 1 under your belt and now 
you’ve added basic iOS app interactions to 
your tool box. 



Views arc constructed in Interface Guilder: 

A view is made up of nib (*.xib) files and the GUIs are edited 
with Interface Builder. 



then, you write the code that makes the 
views work... 

This code is almost always written in Objective-G using 
Xcode，and includes IBActions and IBOutlets. 



,.and connect component events to the 
code. 

Back in Interface Builder, you connect your actions and 
outlets to the components you included in your view. 



The Simulator runs your app virtually. 

As you build your app, you can run your code in the 
simulator and test it to see if it works. 


you are here ► 
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2 !0S app pcitterns 


參 


Hello, Renee! • 



mailto ： grandmom 

body ： please bring me some soda, rm so 
over the milk. 

Sent from my iPhone 


Apps have a lot of moving parts. OK, actually, they don’t have any real 
moving parts, but they do have lots of Ul controls. Atypical iOS app has more going on 
than just a button, and it’s time to build one. Working with some of the more complicated 
controls means you’ll need to pay more attention than ever to how you design your app. In 
this chapter, you’ll learn about some of the fundamental design patterns used in the iOS 
SDK, and how to put together a bigger application. 


this is a new chapter 


mike needs your help 







You have this friend Mike. He has a great girlfriend, 
Renee, but they’ve been having some problems. She 
thinks that he doesn’t talk about his feelings enough. 


0 


O 


O 


I could use my iPhone to send her emails 
about my feelings, but ifs so much work. 
Can you speed that process up? 


There’s (about to be) an app for that. 

Using some solid design and the basic controls 
included in the Interface Builder library, you can 
have Mike sending off emails in no time. The app 
can handle filling out some basics, setting it up to 
go straight to Renee, and Mike can just fill in some 
blanks. But first, what should his messages say? 
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iOS app patterns 


First wg need to figure out 
what Mike (really) wants 


Mike isn’t a complex guy. He wants an easy interface to 
create his emails and he really doesn’t want to have to 


type much. 



ttevVs y/ha-t Mike 

hdrtdedl you a-t 七 he 



App Magnets 



Now that we know what Mike wants, what do we need to do? Take 
the magnets below and put them in order of the steps you’ll follow 
to build his email app. 



sta^dav-d 

\0S Ul elements v/cVc 50*^5 to use. 


pa*ta V^cv-c wca^ s M’ke s 
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start with the app layout 



App Magnets Solution 


Now that we know what Mike wants, what do we need 
to do? Take the magnets below and put them in order 
of the steps you’ll follow to build his email app. 



youVc 七 Wmk … 







Figure out how to use 
the controls 




s 驗 sr 




Wcirc wc y\eeA ^ 

^ l ： l e 



㉗ 卜 — 



tWeiOre no o 

Dumb Questions 


How do you figure out the app layout? 


We’re going to give you a couple to choose from to get started, 
but in general, it's important to think about what your app needs to do 
and focus on those features first. 


Are we always going to start with a sketch? 

Yes! Good software design starts with knowing what you’re 
building and how the user is going to work with the app. Expect to 
spend about 50 percent of your development time on the UI—it's 
what separates the great apps from the rest. 

How do we talk to the email messaging framework? 


Don’t worry, we’ll give you some code to help you to work 
with that. 

Why isn’t Mike texting Renee? Why send an email? 

Simply put, because that won’t work in the simulator. Once 
you have a good handle on creating the email, porting that to texting 
isn’t hard. 

Does every control work differently than the others? 

For the most part, no—once you learn a few basic patterns, 
you’ll be able to find your way through most of the SDK. Some of the 
controls have a few peculiarities here and there, but for the most part, 
they should start to look familiar. 
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APP LAYOUT CONSIRIJCIION 


Here are two designs to evaluate. Based on 
aesthetics, usability, and standard iPhone app 
behavior, which one is better for Mike? 


Option #1 


end'll 


u 此 so 〆 
mscrt 3 
novels 


usev 灼 awe 

Tent Wd 
Jpov 


Option #2 


2:44 PM 


Carrier 


Ihs-taEmail 


Labels tV^at 
a V>c vavt- 
0 Jf ewa “ 


hello 


dV/CSome 


about it 


Sc^d Button 
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P'rc^oh-pijuv-cd 


Which Ul is better? 


Why? (Be specific.) 


Why not the other? 
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keep it simple 





APP MYOIJI CONSTRUCTION 


Here are two designs to evaluate. Based on aesthetics, 
usability, and standard iPhone app behavior, which 
one is better for Mike? 


^ 2 ^ Option #1 


w d。bd 


Carrier 2:44 PM 

Ls-taEmail 
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Which app is better? h . 

Why? (Be specific.) Option 养 Z has a lo*t less -typm^ ar\d -fewer -fields overall. 
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i*t oy\ *thc md'm view cvevy *time he v-u^s *the app. 

Why not the other? Option 养 I has a lo*t o*f sc-ttm^s *bo v-emdnabev. The buttons are do^-fusm^. 
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^0®^* Option #2 
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Tkis is tke one 
you’re going to 
Luilct lor Mike. 


Do I really need to care about usability and aesthetics 
so much? 

Usability and aesthetics are what made the iPhone a success, 
and Apple will defend them to the death. Even more important, you 
don’t get to put anything on the App Store or on anyone else’s iPhone 
without their approval. Apple has sold billions of apps—if yours 
doesn’t fit with the iPhone look and feel or is hard to use, people will 
find someone else’s app and never look back. 

We got rid of the username, password, and email fields. 
The email one I understand, but what about the other two? 


Anytime your app needs configuration information that the user 
doesn’t need to change frequently, you should keep it out of the main 
task flow. Apple even provides a special place for these called a 
Settings bundle that fits in with the standard iPhone settings. We’re 
not going to use that in this chapter (well just hard code the values), 
but later well show you how to put stuff in the Settings page. That’s 
usually the right place for things like login details. 

How am I supposed to know what Apple thinks is good 
design or aesthetically pleasing? 

Funny you should ask...go ahead, turn the page. 
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whafs your (app) type? 


App design rules — the iOS HI& 

The iOS Human Interface Guide (HIG) is a document that Apple 
distributes for guidance in developing iOS Apps for sale on the App 
Store. You can download it at http:/ / developer.apple.com/ios. This isn’t just 
something nice they did to help you out; when you submit an app for 
approval, you agree that your app will conform to the HIG. 

We can’t overstate you have to follow the HIG, as Apple’s 
review process is thorough and they will reject your application if 
it doesn’t conform. Complain, blog with righteous anger, and then 
conform. Now let’s move on. 

Apple also distributes a few other guides and tutorials, including the 
iPhone Application Programming Guide. This is another great source of 
information and explains how you should handle different devices, like 
the iPhone, devices with old versions of iOS, and the iPod Touch. Not 
paying attention to the iPod Touch is another great way to get your app 
rejected from the App Store. 

Application types 

The HIG details three main types of applications that are commonly 
developed for the iPhone. Each type has a different purpose and 
therefore offers a different kind of user experience. Figuring out what 
type of application you’re building before you start working on the 
GUI helps get you started on the road to good interface design. 


N 。 一 f 义:二 


vjovV- 



Immersive Apps 
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Productivity Apps 
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署 


秦 T 夺 


Below are a bunch of different application ideas. For each one, think about what kind 
of app it really is and match it to the app types on the right. 


App Description Type of App 

InstaEmail 1.0: Allows you to email 
with minimal typing. 


News Reader: Gives you a list of 
the news categories and you can 
get the details on stories you 
choose. 


Immersive Application 


Marble Game: A marble rolling 
game that uses the accelerometer 
to drive the controls. 


Utility Application 


Stopwatch Tool: Gives you a 
stopwatch that starts and stops by 
touching the screen 


Productivity Application 


Recipe Manager: A meal listing 
that allows you to drill down and 
look at individual recipes. 
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who does what solution 










Match each app description to its application type. 


App Description 


InstaEmaill .0: Allows you to create 
an email with minimal typing. 




Sih ^ his 

h<3s j lis£^ r News Reader: Gives you a list of 
(^"/- 如⑽ ，VCh, the news categories and you can 

> Wd . 

〜〜 ivi 士 y. 


get the details on stories you 
choose. 


TV^c 
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Marble Game: A marble rolling 
game that uses the accelerometer 
to drive the controls. 


v< 
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-foduscd 
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Stopwatch Tool: Gives you a 
stopwatch that starts and stops by 
touching the screen 


Recipe Manager: A meal listing 
that allows you to drill down and 
look at individual recipes. 


Type of App 

Sih^C WC have ohC S^vcCh 

ahd ho Vn is 

叫 c J a Utility 



Immersive Application 


Utility Application 


Productivity Application 


data "to wovk though hcv-c ： tables, a 
dHlI-doy/h h> ^dipcs-dc-fihilcly productivity. 


f^elax 


We ? re going to get into more HIG 
elements later. 


This is just the beginning of our relationship 
with the HIG. As we start designing apps, we’re 
going to be using platform-specific technologies (like cameras) and 
working with some physical analogs for the iPad. 
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Hlft guidelines for pickers and buttons 


The HIG has a section on the proper use of all the standard controls, 
including the two that we’ve selected for InstaEmail — a picker and a 
button. Before you build the view with your controls, it’s a good idea to 
take a quick look at the recommendations from Apple. You’ll find this 
information in the HIG, under iOS UI Element Usage Guidelines. 



丁 he \rouhdcd \rcdt3hfl\lc 
button is pvctty 
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a new view 


Create a wew View-based project 
for InstaEmail 


Once you’ve started Xcode, select File^New^New Project. Just like iDecide, 
for InstaEmail we have one screen and we’re not going to be animating it (like the 
utility app) or starting with a particular navigation for the app, so again choose the 
View-based Application targeted for iPhone and name it InstaEmail. 


this? 

To write an app that can 
send an email, we’ll need to 
add a new framework. With 
the project and its targets 
highlighted, select Build 
Phases, expand the Link 
Binary With Libraries 
section, and push the + button. 
Then select MessageUI 
Framework from the list and 
click Add. 

Just to keep things organized, 
drag the new Framework into 
the Frameworks folder. 



TW 、 s、s 


Wcvc a\rc the 
highlighted targets. 


一 InUaErTuil - InstaErruil.xcodeproj 


InstaE 
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Info 


Build Settings 


Build PHjscs 
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Build ltul«s 




The new project type in Xcode is not 
necessarily the same as your app type. 


For example, a Productivity App can be written as a 
View-based Application, a Window-based Application: 
Navigation-based Application, or a Tab Bar Application. 



We’H be v/ovkm^ 
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O 


Alright, wait a minute. I still don’t really get 
this ''a .xib file is a nib is a view" thing. I get 
that I can edit this view in Interface Builder, 
but how does it all fit in with everything else? 


Fair enough. 

It can get a little confusing. Let’s take a 
look at how a nib really becomes a view... 
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where your view comes from 

The life of a root view 

In Chapter 1, we touched on how the Xcode GUI editor creates 
XML descriptions of your view, called a nib, and that the Cocoa 
Touch framework turns that into a real view in your application. 
Let’s take a closer look at what’s going on under the hood. 



o 


o 


Like in most other languages, main(...) gets called first. 

When your application is launched by the user, the iPhone provides a quick 
animation of your app zooming into the screen (this is actually a PNG file 
you can include with your app), and then calls your main method. Main is 
provided by the templates and you almost never need to touch it. 


❺ 


Main 

Window 


Main kicks off a Cocoa Touch Application. 

The standard main (…） kicks off a Cocoa Touch 
UIApplicationMain, which uses the information in 
your application’s Info.plist file to figure out what nib 
to load. With the View template we used, it’s a nib 
called MainWindow.xib. 



^ is the 

匕〜 Cohi\roll 

I 七 s ^d3sscs 
U ^Co^ 0 ll 


Clr. 


CK 




MainWindow.xib contains the 
connections for our application. 

If you look in MainWindow.xib, 
you’ll see it has an instance of our 
InstaEmailAppDelegate for its 
UIApplicationDelegate and an instance 
of our InstaEmailViewG ontroller. 
When the Cocoa Touch 
framework loads Main Window, 
xib, it will create an instance of our 
InstaEmailViewG ontroller and tell it to 
load our InstaEmailViewGontroller.xib. 







lh a 
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The Cocoa Touch framework creates our custom view from the 
InstaEmailViewController.xib. 

When we constructed the nib, we used the File’s Owner proxy object to stand in for the 
object that owns the nib contents. At this point, the framework is loading the nib on 
behalf of our InstaEmailViewGontroller class, so that instance is used for connections. As 
the framework creates instances of our components, they’re connected up to the instance 
of InstaEmailViewG ontroller. 


TWis is 


0 阶 vic w . H 


r by ih c 

4 ^wCo^ ol , e t M+ 







I Cupertino 
1 Santa Clai 

I San Jose 


about it. 


Send Email 


■ 


Tj^T iali ^ d 

以 —: ,,y 


When events occur with components, methods are invoked on our 
controller instance. 

The actions we associated between the controls and the File’s Owner in the nib 
were translated into connections between the controls and our controller instance 


(InstaEmailViewGontroller). Now when a control fires off an event (like the Send Email 
button), the framework calls a method on our InstaEmailViewG ontroller instance. 
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no dumb questions 


Isn’t good design vs. bad design a 
little subjective? 

Yes and no. Obviously, different 
people will have differing opinions about 
what UI looks better. However, Apple has 
very specific guidelines about how certain 
controls should be used and best practices 
that should be followed. In general, if you’re 
using a common iOS control, make sure 
you’re using it in a way that’s consistent with 
existing applications. 

Can I run apps that I build on my 
own device? 

To get an app you write installed 
on your iPhone, you'll need to sign up for 
either the Standard or Enterprise Developer 
programs at http://developer.apple.com/ios/. 
Everything in this book is designed to work 
with just the Simulator, so don’t feel like you 
need to go do that just yet. We'll talk more 
about putting apps on an actual phone later 
in the book. 

The InstaEmail icon looks horrible. 
What can I do? 



The icon for an application is just 
a PNG file in your project. We’ll add and 
configure icons later, but for now, just know 
that you’ll need a .png file in the resources 
directory for that purpose—we'll hook you up 
with some cool icons in a bit. 

Q/ Do I have to use the GUI builder for 
the view? 

No. Everything you do in the Xcode 
editor can be done in code. Interface Builder 
makes it a lot easier to get things started, 
but sometimes you’ll need that code-level 
control of a view to do what you want. We’ll 
be switching back and forth depending on 
the project and view. 

Q/ I’m still a little fuzzy on this nib 
thing. Do they hold our Ul or regular 
objects? 

They can hold both. When you 
assemble a view using the Interface Builder 
GUI editor, it keeps track of the controls 
you're using and the links to other classes. 
These controls are serialized into an XML 
document; when you save it out, this is your 


nib. Xcode is able to serialize non-control 
classes, too. That’s how it saves out our 
InstaEmailViewController in MainWindow.xib. 
When the nib is restored from disk, objects 
in the nib are reinstantiated and populated 
with the values you gave them in Interface 
Builder. 

You can think of it like “freeze-drying” the 
objects and then restoring them at runtime. 

So does the editor save out the 
File’s Owner, too? 

No, File’s Owner is a proxy. File’s 
Owner represents whatever class is asking 
to have this nib loaded. So the File’s Owner 
proxy isn’t actually stored in the nib, but 
Interface Builder needs that proxy so you 
can make association with controls you used 
in your view. When the nib is restored (and 
the control objects are instantiated), the nib 
loading code will make the connections to the 
real owning object that asked to load the nib. 
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Edit the labels and button text for the 
title, “I’m”，“and feeling”，and “about it ’’， 
as well as the title for the button. Don’t 
worry about the picker values (like “hello 
worlding”) just yet. 


Select the top label to start setting the text. 
The title can be edited in the top of the 
utilities panel. 


It’s time to build the view. Double-click on 
InstaEmailViewController.xib in the InstaEmail folder, and launch 
the Interface Builder GUI editor inside of Xcode. Using drag and 
drop, pull over the elements from the Utilities panel that you 
need to build the View. 


Find each of the elements (we’ve given them the 
proper names for you) in the objects library and 
drag and drop them into the View window. 
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Once you save it, your 
view should look like 
this... 
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preview your view 



The View is all built and ready to go. Here’s what you should 
have on your screen now. Once you tweak everything to look 



Did you ho-tidc the blue guidclihcs ih -the simulaW? ThcyVc 
； h Vicw whch youVe laying out io you 
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TesT DriVq 


Now it’s time to check out InstaEmail in the Simulator. Save 
in Interface Builder, go back into Xcode, and hit Run from 
the Build menu (or use the keyboard shortcut §€+R). 



Close, tut tke picker isn’t 
skowingf up?!?! 





Why do you think the picker isn’t showing up? 
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digging up some data 


Wc need data 

For the picker to actually show up, we have to give it data to display. And Mike is 
just the guy to help. He likes what you have put together for the UI, so now we 
need a little more information from him to give to the picker. 
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Use pickers whew you wawt 
controlled input 


In our case, the picker is the perfect element for 
our app. No typing at all, but it allows Mike to 
have control over what gets selected. There’s some 
terminology that you need to know about pickers 
before we get our data in there. 
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㈣ 35: 


OK, so we can just set the picker rows 
with the values Mike gave us like we did 
with the button label, right? 


The picker is different. 

The picker doesn’t want to be told what 
to do, it’s going to ask when it wants your 
input. You’re going to see this pattern 
show up with controls that could use a 
lot of data like pickers, and later we’ll see 
something similar with table views. Let’s 
take a closer look... 
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datasources and delegates 

Pickers get their data from a datasourcc... 

Many of the elements in the Cocoa Touch framework have the concept of datasources 
along with delegates. Each UI control is responsible for how things look on the screen (the 
cool spinning dial look, the animation when the user spins a wheel, etc.), but it doesn’t know 
anything about the data it needs to show or what to do when something is selected. 

The datasource provides the bridge between the control and the data it needs to display. 

The control will ask the datasource for what it needs and the datasource is responsible 
for providing the information in a format the control expects. In our case, the datasource 
provides the number of components (or columns) for the picker and the total number of 
rows for the picker. Different controls need different kinds of datasources. For the picker, 
we need a UIPickerViewDatasource. 


ttcy— usev- jus*t 
spu^ me *to \rov/ 3. 





Datasource 


...and tell their delegates whew something happens 

As we saw in Chapter 1, a delegate is responsible for the behavior of an element. 

When someone selects something — or in this case, scrolls the picker to a value — the 
control tells the delegate what happened and the delegate figures out what to do in 
response. Just like with datasources, different controls need different kinds of delegates. 

For the picker, we need a UIPickerViewDelegate. 

o 


When in doubt, check out Apple’s documentation 

You’re probably wondering how to use that picker, so don’t 
hesitate to check out the API documentation. In Xcode, 
go to the Help menu and then the Xcode Help option. 

Search for “UlPickerView” and it will pull up all the information on the 
class that you need to implement for the picker. 
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Dumb Quest? 


9ns 


Why is the delegate providing the content? That really seems like data. 

That’s something particular to a picker and it has to do with the fact that the picker delegate can change how the data is shown. In the 
simplest form, it can just return strings to the picker. If it wants to get fancy, it can return an entire View (yes, just like the View you built with 
Interface Builder, but smaller) to use images or special fonts, for example. 


That pattern is back 

You’ve seen this Control-Datasource-Delegate pattern 
before, when we briefly discussed MVG in Chapter 1. Nearly 
all the complex controls use it. You’ll probably remember that 
even the View-View Controller relationship we’ve been 
using follows this pattern (minus the datasource). 


Controls have their own specific 
datasources and delegates 



Each control has specific needs for its datasource and delegate, and 
we’ll talk about how that’s handled in Objective-G in a minute. 
However, it’s important to realize that while the responsibilities are 
split between the datasource and the delegate in the pattern, they 
don’t necessarily have to be implemented in different classes. The control 
wants a delegate and a datasource — it doesn’t care whether they’re 
provided by the same object or not: it’s going to ask the datasource for 
datasource-related things and the delegate for delegate-related things. 

Let’s take a closer look at how the UlPicker uses its datasource and 
delegate to get an idea of how all of this fits together. 
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picking apart the picker 



The FicKcv 

This week’s interview: 

How to avoid spinning out of 
control... 


Head First ： Hello, Picker, thanks for joining us. 

Picker ： My pleasure. I don’t usually get to talk to 
anyone but my datasource and delegate, so this is a 
real treat. 

Head First ： I’m glad you brought those up. So 
we’ve worked with controls like buttons and labels, 
but they just had properties. What’s going on with 
this delegate and datasource business? 

Picker ： Well, to be clear, I have properties too — 
there just isn’t too much exciting going on there. 
What makes me different is that I could be working 
with a lot of data. I might only have one row or 
I might have a hundred; it just depends on the 
application. 

Head First ： Ah, OK. A label only has one string 
in it, so there can be a property that holds just that 
string. No problem. 

Picker ： Exactly! So, instead of trying to cram all of 
the data into me directly, it’s cleaner to just let me ask 
for what I need when I need it. 

Head First ： But you need to ask for it in a specific 
way, right? 

Picker ： That’s the beauty of my setup. I ask for 
what I need to know in a specific way — that’s why 
there’s a UIPickerDatasource — but I don’t care 
where my datasource gets its information. For 
example, I need to know how many rows I need to 
show, so I ask my datasource. It could be using an 
array, a database, a plist, whatever — I don’t care. For 
a picker, I’m not that picky...all I need to know is how 
many rows. 

Head First ： That’s really nice — so you could be 
showing data coming from just about anything, and 
as long as your datasource knows how to answer 


your questions, you don’t care how it stores the data 
internally. 

Picker ： You got it. Now the delegate is a little 
different. I can draw the wheels and all that, but I 
don’t know what each application wants to do when 
someone selects a row, so I just pass the buck to my 
delegate. 

Head First ： So the delegate is implemented so 
that when you tell the delegate what happened, it 
performs the right action. Like saving some value or 
setting a clock or whatever. 

Picker ： Exactly, so by using the delegate, you don’t 
have to subclass an object to customize behavior. 
Now, I have to confess I have one little oddity going 
on... 

Head First: Oh, I was waiting for this. This is 
where you ask the delegate for the value to show in a 
row, right? 

Picker ： Yeah 一 other controls ask their datasource. I 
could come up with a lot of excuses, but...well, we all 
have our little quirks, right? 

Head First ： I appreciate your honesty. It’s not all 
bad, though; your delegate can do some neat things 
with each row, can’t it? 

Picker ： Oh yeah! When I ask the delegate for a 
particular row, it can give me back a full view instead 
of just a string. Sometimes they have icons in them 
or pictures — really, anything you can cram in a view, 
I can display. 

Head First ： That’s great. Well, we’re out of time, 
but thanks again for stopping by. 

Picker ： My pleasure! Now I’m off to take my new 
datasource for a spin. 
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Match each picker characteristic to where it belongs — the delegate or 
the datasource. You’ll need to go digging in the API to figure out where 
the three methods go. 



Directions for drawing the view 
for the items 


Delegctte or dettasource? 


The number of components 


Delegate 


pickerView : numberOfRowsInComponent 


pickerView : titleForRow : forComponent 


Datasource 


The row values (strings or views) 


numberOfComponentsInPickerView 
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picker parts 








•备韆 


Match each picker characteristic to where it belongs — the delegate 
or the data source. You’ll need to go digging in the API to figure out 
where the three methods go. 


picker characteristic (or method) 


Directions for drawing the 
view for the items 


The number of components 


pickerView : numberOfRowsInComponent 

A ^rc«\ui\rcd pa\rt o( Ihc U|Pidkcv\/icwDataSou^c 
P\ro-todol "that v*c*tu\r^s -the ^urwbcv- o( vows. 


pickerView : titleForRow : forComponent 




The row values (strings or views) 


numberOfComponentsInPickerView 



A ve<\u'ired fav-t i\\t U |P*itkc\r\/*ic>Mpa*taSou\rdc 

Pv-o*todolj vc*tuvir>s o( domfo 灼 eirrU- 


Delegctte ox dcttcisource? 



Delegate 


Datasource 


Working togetker, tke 
delegate anct tke datasource 
provide wkat is neected to 
rentier tke picker. 
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O 


o 


Hang on—there are protocols in both the datasource 
and the delegate? 



Protocols define what messages the datasource and 
delegates need to respond to. 

Pickers (and other controls that use delegates and datasources) have specific 
messages to which their supporting classes need to respond. We’ll get into 
them in more detail in the next chapter, but for now what you need to know 
is that messages are defined in protocols. Protocols are Objective-CTs idea 
of a pure interface. When your class can speak a particular protocol, you’re 
said to conform to it. 



ttey — 七 he uscv- \us*t 一 
spun me *fco Vow 3. 




/ Delegate^ ^ 

\ -/ 


So how vov/s 

do 

I 


A 。 u r 


iVhats -the value 

•fov \rov/ S? 



Datasource —vasc ^° r 


OVA( 




Protocols tell you what methods 
(messages) you need to implement 





〜 OV 叫 





Protocols typically have some required methods to implement and others that are 
optional. For example, the UIPickerViewDatasource protocol has a required method 
named pickerView:numberOfRowsInGomponent; it has to be in the datasource 
for the picker to work. However, UIPickerViewDelegate protocol has an optional 
method named pickerView:titleForRow:forGomponent, so it doesn’t need to be in 
the delegate unless you want it. 

So how do you know what protocols you need to worry about? The documentation 
for an element will tell you what protocols it needs to talk to. For example, our 
UlPickerView needs a datasource that speaks the UIPickerViewDataSource 
protocol and a delegate that speaks the UIPickerViewDelegate protocol. Click 
on the protocol name and you’ll see the documentation for which messages are 
optional and which are required for a protocol. We’ll talk more about how to 
implement these in the next chapter; for now, we’ll provide you the code to get 
started. 
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sometimes it’s okay to conform 


First declare that the controller conforms 
to both protocols 

Now that you know what you need to make the picker work, namely a delegate and a datasource ， 
let’s get back into Xcode and create them. Under Classes, you have two files that need to be edited: 
InstaEmailViewGontroller.h and InstaEmailViewGontroller.m. Both files were created when you started 
the project. 

The .h and .m files work together, with the header file (.h) declaring the class’s interface, variable 
declarations, outlets, and actions, etc.; the implementation file (.m) holds the actual implementation 
code. We need to update the header file to state that our InstaEmailViewGontroller conforms to both 
the UIPickerViewDataSource and the UIPickerViewDelegate protocols. 


加 ad a 十 

Wat 、 V>oWed’ 




^import <UIKit/UIKit•h> 

Qinterface 工 nstaEmailViewController : UlViewController 

<UIPickerViewDataSource , UIPickerViewDelegate> { 

NSArray* activities 
NSArray* feelings 


@end 




IA/cVc jomj bo set ^ tv/o a^ays U M 心 
onC -fov attW'itics ar^d -fov 心 elmy. 


VC ur\dicv-SdoV-cdi *to keep 

邊 k l*b’s Y\oi 代 ― 代 d! 



tWs ^ 

6 (ass Will do^ovm to the 

U |P ， 6 kevV_ ， cv/Pa*ta SouV ^ 




Next add Mike's activities and feelings to the implementation file 

Now we’re into InstaEmailViewG ontroller. m file, the actual implementation. We’ll need to add 
some methods to implement the required methods from the protocols, but we’ll get back to that in 
a second. First, let’s add the list from Mike. We’re going to use the two arrays we declared in the 
header to store the words that Mike gave us. 


A 、、 


#import ''InstaEmailViewController. h" 

@implementation InstaEmailViewController 






InstaEmailViewController.m 
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， method gets ^llcd oh youv view 

thc vicw " 

the .X,b f,lc. This is wh^c you (lah do some 
'hrt.ali 2 ^t,oh ahd setup 4 v the view. 



// Implement viewDidLoad to do additional setup after ... 
- (void)viewDidLoad { 


[super viewDidLoad]; 

activities— = [[NSArray alloc] initWithObjects : Q^sleeping' 
@’’eating", @’’working’’ ， @"thinking" , @"crying", @"begging", 

@"leaving" , @’’shopping", @"hello worlding" , nil]; 

feelings— = [[NSArray alloc] initWithObjects:@"awesome", 

@"sad", @"happy", @’’ambivalent’’ ， @’’nauseous", @’’psyched", 
@"confused", @"hopeful", @"anxious", nil]; 



Th” bc-Povc those s-tHhas idls -thi? d I i 

U St ? d ^:呼 

/2 / I ! vc- ^ as opposed -to a simple 



Hcv-c ； wc 
cs-fc^blish the 

3vvays with 

/Wikcs lists. 

_ “II 

3 bit {jo -fill 
the pi 匕 kev. 


ih 


InstaEmailViewController.m 


isscs use 


- (void)dealloc { 

[activities release] 
[feelings. Release]; 

[super dealloc]; 


>u *to release all objects 

-to -Pvcc *tV^c memov-y *b^cy weve 

usi ， lAfe’ll talk about 

a lot ^ov-c *m 孓 . 




InstaEmailViewController.m 


Now we just neect tke protocols … 


you are here ► 


69 







how many rows? 


The datasource protocol has two 
required methods 


Let’s focus on the datasource protocol methods first. We said in 
the header file that InstaEmailViewGontroller conforms to the 


UIPickerViewDatasource protocol. That protocol has two required 
methods: numberOfGomponentsInPickerView:pickerView and pickerV 
iew:numberOfRowsInGomponent. Since we know we want two wheels 
(or components) in our view, we can start by putting that method in our 
implementation file. 


TWis todc 


,v-\cs yrCBt. 


Wtrt avc 七 k 
■bwo \rc<\ui\rcd 
mc*tKods (or 


#pragma mark - 


#pragma mark Picker Datasource Protocol logid. 


The is -Pov- y^toAt] i-t help 

bv*cak up -the Code, but docs^^-t pv-ovidc 


(NSInteger)numberOfComponentsInPickerView : (UlPickerView *) pickerView 
return 2; ^ Wow 

} ^ompohcirts? 


- (NSInteger)pickerView : (UlPickerView *)pickerView numberOfRowsInComponent 
: (NSInteger) component { _ ^ oy/ vows m 

if (component == 0) { - - T\\C^ Con\t 

return [activities 一 count] ; arrays, so v/C Y\ttd 

i -to *tv-ca*t scfava-tcly* 


else 


return [feelings count]; 


Our second method needs to return the number of rows for each 


InstaEmailViewController.m 


component. The component argument will tell us which component the 
picker is asking about, with the first component (the activities) as component 
0. The number of rows in each component is the just the number of items 
in the appropriate array. 
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Now tkat we kave tke metkocts implemented ， 
let’s wire everytkingf up to tke picker. 
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CowwGctthc datasourccjust like actions 
and outlets 


Now that the datasource protocol is implemented, the data is in place and 
it’s just a matter of linking it to the picker. Hop back into Interface Builder 
to make that connection: 



o 


Right-click on the 
Picker in the view 
to bring up the 
picker connections 
box. 



Notice that the File’s Owner for this view is our InstaEmailViewGontroller, which 
realizes the datasource and delegate protocols we need. You need to connect the 
picker’s dataSource to our controller, or the File’s Owner. To do that, click inside 
the circle next to the dataSource, and drag over the to File’s Owner. 
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getting to a specific row 

There's just om method for the 
delegate protocol 

The UIPickerViewDelegate protocol only has one required method 
(well, technically there are two optional methods, and you have to 
implement one of them). We’re going to use pickerView:titleForRow: 
for Component. This method has to return an NS String with the title 
for the given row in the given component. Again, both of these values 
are indexed from 0, so we can use the component value to figure out 
which array to use, and then use the row value as an index. 


今 w you w j 


#pragma mark - 

#pragma mark Picker Delegate Protocol 

- (NSString *)pickerView : (UlPickerView *)pickerView 
titleForRow:(NSInteger)row forComponent:(NSInteger)component { 

0 u\r t\\o\Ct o( iv/o methods, oy\c o( 
if (component == 0) { whi 匕 h -fco be 

return [activities objectAtlndex : row]; 


else 


return nil; 


return [feelings 一 objectAtlndex : row], 

Rc*tuv-y\ av-v-ay a*t *1 

appvofV'ia'tc lo^3*tioir\ 一 v-ov/ 0 is *bi^c 
s*bv*m5> v~ow I sctor\d> C*t4- 




InstaEmailViewController.m 


Now back to tire view to 
wire up tke ctelegate … 


72 Chapter 2 






InstaEmail - InstaEmailViewController.xib 



InstaEmail InstaEmail a 7 InstaEmailViewController.xib a 7 InstaEmailViewController.xib (Eng... View || Picker 


% 


J 


¥ 


Label - about it. 
Button - Send Email 


0 Placeholders 


File's Owner 

First Responder 


雄 Objects 

― - ■ 

View 

、• 

— 

Label - InstaEmail 

Label - rm... 

Label - and feeling •“ 




InstaEmail 

and feeling... 



o 


Santa Clara 

San Jose 



aba 


Senq 

v —— 


O Picke^^ 

T Outlets 、 

dataSourc-e 
delggat€ 

T Referencing Outlets 
New Referencing Outlet 

▼ Referencing Outlet Collections 
New Referencing Outlet Collection 


❺ 
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Right-click on the picker 
again and bring up the 
connections window. 


The File’s Owner 

realizes the delegate 
protocol as well. Click 
inside the circle next 
to the delegate and 
drag over the to File’s 
Owner. 




Tesr DriVq 


Save your work in and Run ( 昶 +R) the app. When the Simulator 
pops up, you should see everything working! 


从 0 兄 dials-thcyVc 
^ih 9 s oh mcs 

l,si ay)d 赠 k ^cail 
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no dumb questions 


What happens if I don’t implement a 
required method in a protocol? 

Your project will compile, but you’ll 
get a warning. If you try to run your 
application, it will almost certainly crash with 
an “unrecognized selector” exception when 
a component tries to send your class the 
missing required message. 

What if I don’t implement an 
optional method in a protocol? 

That’s fine. But whatever functionality 
that it would provide isn’t going to be there. 
You do need to be a little careful in that 
sometimes Apple marks a couple of methods 



as optional but actually, you have to 
implement at least one of them. That’s the 
case with the UIPickerViewDelegate. If you 
don’t implement at least one of the methods 
specified in the docs, your app will crash 
with an error when you try to run it. 

Are there limits to the number of 
protocols a class can realize? 

Nope. Now, the more you realize, the 
more code you’re going to need to put in 
that class, so there’s a point where you 
really need to split things off into different 
classes to keep the code manageable. But 
technically speaking, you can conform to as 
many as you want. 


I’m still a little fuzzy, what’s the 
difference between the interface we put in 
a header file and a protocol? 

An interface in a header file is how 
Objective-C declares the properties, fields, 
and messages a class responds to. It’s 
like a header file in C++ or the method 
declarations in a Java file. However, 
you have to provide implementation for 
everything in your class’s interface. A 
protocol, on the other hand, is just a list 
of messages—there is no implementation. 

It's the class that realizes the protocol that 
has to provide implementation. These are 
equivalent to interfaces in Java and pure 
virtual methods in C++. 


BULLET POINTS - 

■ The picker needs a delegate and a data- 
source to work. 

■ In a picker, each dial is a component. 


■ In a picker, each item is a row. 

■ Protocols define the messages your class 
must realize—some of them might be 
optional. 
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Now let’s get that button sending 
emails... 

We got the picker working, but if you try out 
the u Send Email” button, nothing happens when 
something’s selected. We still need to get the button 
responding to Mike and then get the whole thing to 
generate and send an email. 




Think about what we need to do to get the 
button working. What files will we use? What will 
the button actually do? 
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no dumb questions 



o O 


So we just need to go back to the 
view and wire up the TouchUpInside event for 
the ''Send Email" button again, right? Just like in 

i Decide? 


Yes! We still need to write the actual 
delegate functionality the button is 
going to trigger, but that’s the idea. 



In^fAFmail - InstafmailVi^wCAnrroll^r.xib 

■sialyl 


4.2 ^ 

imul. ：l l»i 

isialo m 




| D 

JJJ ； -4 ► Inttarmjiil InitafmAil > ^ knitaf maifV t KnUjFmaftW View 

Buttoo - Srnd fmail DBS 

令多丨 © 丨 


hle.t. 

_ hrst Resporxfj 



therejctre no ^ 

Dumb Questions 


What is an event again? 

Ul controls trigger events when things happen to them. You can 
“wire” these events to methods so that your method is called when an 
event is triggered. Most of the time, you can wire events to methods 
using Interface Builder, but you can also do it in code (we’ll do this 
later in the book). 

Why didn’t we have to wire up the picker methods? All we 
did there was set up a delegate and datasource. 


Great question! Some controls have very fine-grained events 
that they trigger. Those individual events can be wired to specific 
methods on other objects (like File’s Owner). Other controls want 
higher-level concepts, like a Datasource or a Delegate. In order to be 
a Datasource or a Delegate for those controls, you have to provide a 
set of methods that the control can call. Those methods are defined 
in a protocol. In the case of the UlPickerView, it doesn’t have lots of 
fine-grained events—instead, it has two key protocols and just wants 
to know which object(s) will implement them. You can’t choose to 
have half the Datasource methods go to one object and the other half 
to go somewhere else. You simply give it a datasource and it will call 
all of the datasource methods on that object as it needs to. 
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Actions, outlets, awd events 

Back in iDecide，we used actions and outlets with a button press. Let’s go back 
for a second to revisit what happened: 



Here’s the action we created for the button press in Chapter 1: 





-( 工 BAction) buttonPressed : (id)sender; 

Lll j s ^ ^ "UN - 



㈣ iS 


tv •實 


cd tv^c a6t\ 
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IBActions and IBOutlets 


Fireside Ghats 



Tonight’s talk ： IBActions speak louder than...a lot of things 


IBAction: IBOutlet: 

Hi, Outlet. What’s it like to only be an enabler? 

What are you talking about? I do stuff. 

Uh 一 I’m an Action, all about doing. My job is to do 
something when something else happens — an event. 

That’s getting something done. You just sit there 
and point to stuff going on. 

Big deal. At least I’m aware of everything going on. 

Yeah, but when the user does something, I make it 
happen! I do the saving, I do the email sending! 

Listen, it’s true that I’m just an instance variable 
that works with an object in a nib, but that doesn’t 
mean I’m not important. 

Really, because the compiler just ignores you! 

It does, but I tell Interface Builder in Xcode a lot. 
You’re not very tight with IB, are you? 

Well, for starters, the “IB” in IBAction stands for 
Interface Builder! 


Big deal, I have “IB” in my name, too. 

Well, we do have that in common. Anyway, 

Interface Builder knows when I’m around so that 
some event in a nib can set me off and keep me 

informed. Well, I guess that is pretty important. 


Thanks. That’s nice of you to admit. 
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IBAction: IBOutlet: 

But I’m secure in my relationship with Interface 
Builder. Without me, the code couldn’t change 
anything in the UI. 

Care to explain? 

Sure. An IBOutlet variable can point to a specific 
object in the nib (like a text field or something), and 
code (yes, probablyj ⑽ r code) can use me to change 
the UI, set a text field’s content, change colors, etc. 

Oh—I see. You know, there is one thing that you 
have that I’ve always wanted. 

What’s that? 

You can be anything! Stick IBOutlet in front of a UI 
component’s variable name and you’re good. I have 
more complicated syntax, because I need to have 
the idea of a sender in there. 

I do like the freedom! Glad we could work things out. 


Me too. 



Change both the header and implementation files for the 
InstaEmailViewController to include the 旧 action info we 
need. 



Start with the header and add an IBAction named sendButtonTapped. 



Then provide an implementation for that method in our .m file, and 
write a message to the log so you know it worked before creating the 
email and sending it off. 
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exercise solution 


■ Declare your 旧 Action in the header file and 

E%6HClS6 provide the implementation in the .m file. 

SotutloH 


o 


^import <UIKit/UIKit•h> 

Qinterface 工 nstaEmailViewController : UlViewController 
<UIPickerViewDataSource, UIPickerViewDelegate> { 

NSArray* activities 」 The is whal allows ihe Code 

NSArray* feelings 」 bo a user v-cr ， cr ， bcv-... 


(IBAction) sendButtonTapped : (id) sender; 



❺ 


#pragma mark - 
#pragma mark Actions 


Dctla\rc you\r lBA^bor\ hc\rc so wc use ii 
•m the rtn -file and l^tc\r-fadc Builder krtows 
we have 9r\ dvdildble. 

Add tWis \>\i todt 
^ todc. 



InstaEmailViewController.h 


Saw method dctUvatioh as the M 


(IBAction) sendButtonTapped : (id) sender 
NSLog(@"Email button tapped!"); 


TVis will give you the 
output oh the dohsolc. 






InstaEmailViewController.m 
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0 Placeholders 


sen 


File's Owner 
First Responder 


dButtooTapped: 


^0 Objects 


View 

Label - InstaEmail 
Label - rm••• 

Label - and feeling 
~i Picker 

Label - about it. 



Sent Events 

Did End On Exit 
Editing Changed 
Editing Did Begin 
Editing Did End 
Touch Cancel 
Touch Down 
Touch Down Repeat 
Touch Drag Enter 
^Drjkg Exit 
Touch I 

Touch Drag Outside 
Touch Up Inside 
Touch Up Outside 
Value Changed 

Referencing Outlets 



New Referencing Outlet 


Referencing Outlet Collections 


New Referencing Outlet Collection 


{} 窃 ■ 


I jjj File Template Library 


3 


Objective-C category - An 

Objectrve-C category 





D 


about it. 

Send Email 



Tqst DriVQ 


Save, then click Build and Run. You should get the “Email 
button tapped!” message in the console in Xcode. To see 
it, you need to enable the debugging pane and select All 
Output. 


Connect the event to the action 

Now that you have an action, you need to wire up the event to the action. Open up 
InstaEmailViewGontroller.xib in Xcode with the Utilities pane, right-click on the button, and 
drag the circle for Touch Up Inside to File’s Owner. Link it with your new sendButtonTapped 
method. 



◄ ► I [ InstaEmail ) f , InstaEmail > ^jlnstaEmailV... ,> InstaEmailV ...) View Button - Send Email D S 田 ^ O 
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test drive 



Tqst DriVQ 


Save, then click Build and Run. You should get the “Email 
button tapped!” message in the console in Xcode. To see 
it, you need to enable the debugging pane and select All 
Output. 


ntroller.xib 


bTb] I 圆 



InstaEmail 


and feeling... 


Choose tWis WtW 

)( 6 odc 


i 


ara 


about it. 


Select AH 
Ou*bfu*b V>cv-c. 


All Output i 


::: '： □□口 


GNU gdb b. i. bH-2BHb081!> (Apple version gdb-lblUj ( Ihu Jan ll 
08:34:47 UTC 2011) 

Copyright 2004 Free Software Foundation, Inc. 

GDB is free software, covered by the GNU General Public 
License, and you are 

welcome to change it and/or distribute copies of it under 
certain conditions. 

Type "show copying" to see the conditions. 

There is absolutely no warranty for GDB. Type "show 
warranty" for details. 

This GDB was configured as M x86_64-apple-darwin M .Attaching to 
process 48919. 

2011-02-22 11:19:29.165 InstaEmail[48919:2e7] Email button 
tapped I 


▼ 
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So now we need to get the data from that 
picker for the email, right? Would an 
IBOutlet be the right thing for that? 


Yes! An IBOutlet provides a 
reference to the picker. 

In Chapter 1, we used an outlet to 
access and change the text field value 
on the button. Now, to gather up the 
actual message to create the email, 
we need to extract the values chosen 
from the picker, then create a string 
including the label text. 

So far, the picker has been calling 
us when it needed information; this 
time, when Mike hits the “Send Email” 
button, we need to get data out of the 
picker. We’ll use an IBOutlet to do that. 
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getting the data from the picker 

Add the IPOutkt awd property to your 
view controller 

We need to declare an IBOutlet property and a class attribute to back 
it. We’ll talk more about properties in the next chapter, but in short, 
that will get us proper memory management and let the Cocoa Touch 
framework set our emailPicker property when our nib loads. 


Start with the header file by adding the code in bold below: 


^import <UIKit/UIKit•h> 

Qinterface InstatwitViewController : UlViewController 
<UIPickerViewDataSource, UIPickerViewDelegate> { 

UlPickerView *emailPicker ; 〜代 , w dttUrt a ^\t\d m 

NSArray* activities—; _ 七 he tailed 

NSArray* feelings—; TV\C ,s ^ ^om*bcv *to 3 

} UlP^kcvVic'w. 

@property (nonatomic, retain) IBOutlet UlPickerView *emailPicker 

- (IBAction 、 sendButtonTapped : (id) sender; 


ttev-c s ou\r outlet 
dcdl3v*3*tioh. This lc£s 
Buildcv- khow 
you have somc-thihg -fco 
-to. IBOutlet 

idchti-ficirs avc actually 
#dc-Pihcd -to hothihO ； 
thcyVc just thcv-c (or 

(^tcv-Padc Builder. The 
pomteir exists, though. 




■The p\ropc\rty (or crwailpidkcv has SOWf»C 
nr»Crwo\ry op 七 ions 七 1 ^七 well 

C^plaih rwovc m Chaptcv- Z. 


InstaEmailViewController.h 
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Next synthesize the property... 

Once we set up the declarations for the property and instance variable, we 
need to link them up in the implementation file. We do that with the @ 
synthesize directive. 


#import ''InstaEmailViewController. h" 

@implementation InstaEmailViewController 

@synthesize emailPicker=emailPicker 





and clean up after yourself 


Move or\ 
3s 



InstaEmailViewController.m 


When our view controller is destroyed, its dealloc method will be called. We 
need to make sure we release any memory we’ve allocated. We’ll talk a lot more 
about memory management in Chapter 3, but for now, make sure you release 
each of your class attributes. 



InstaEmailViewController.m 


Wltat’s next? 


you are here ► 


85 









connect the outlet to the code 


Cowwect the picker to our outlet 

You’re probably expecting this by now! Back into the view to make 
the connection from the UlPickerView to the IBOutlet in your view 
controller. Right-click on the UlPickerView, grab the circle next to 
the “New Referencing Outlet,” and drop it on File’s Owner — our 
InstaEmailViewGontroller sporting its new emailPicker outlet. 
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O \^icker 

▼ Outlets 
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delegate it File'sh^oer 

▼ Referencing Outlets 
New Referencing Outlet 

▼ Referencing Outlet Collections 
New Referencing Outlet Collection 
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What do you need to do now to get the data out 
of the picker and into your email message? Think 
about the “Send Email” button action and how that 
will need to change... 
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Use your picker reference to pull the 
selected values 


Now all that’s left is to use our reference to the picker to get the actual values 
Mike selects. We need to change the sendButtonTapped method to pull the 
values from the picker. Looking at the UlPickerView documentation, the 
method we need is selectedRowInGomponent:. That method returns a row 
index we can use as an index into our arrays. 




To wh3i m e /k , 




^ow is 


-( 工 BAction) sendButtonTapped : (id) sender { 

NSString* theMessage = [NSString stringWithFormat:%@ and feeling %@ 
about it .〃， 


[activities 一 objectAtlndex : [emailPicker— selectedRowInComponent:0]], 
[feelings 一 objectAtlndex:[emailPicker 一 selectedRowInConjponent:1]]] 
NSLog (@ ’’ ％ @ ” ， theMessage); 

NSLog (@’’Email button tapped !’’）； 

lA/c II pull tWis I03 message out fut m 如 0 f 
above bo see y/V^a-t Vmal email messay will be. 






.u JfuW “ 七^*七 m * 〆 

一七匕 WW 3 T ⑽拟 InstaEmailViewController.m 

a W ， 

6o,\d a V ⑽七从 〜 0 

cU-, ^ ^ ^ 

CT> 1 >\\ uSC lo&, 

so For now we’re just going to log this message to the console so 

we can see the string we’re building, and then we’ll generate 
the email to send out in just a minute. Let’s make sure we 
implemented this correctly first before emailine Renee. 
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test drive 




TesT DriVq 


OK, try it out. You should get some convincing text in the 
console. 



T 


ClearJ I I 


All Output t 

"CNU gdb b. Le version gflb-lilB, 

(Thu Jan 27 03:34:47 UTC 2011) 

Copyright 2004 Free Software Foundation, Inc. 

GDB is free software, covered by the GNU General 
Public License, and you a re 

welcome to change it and/or distribute copies of 
it under certain conditions. 

Type "show copying" to see the conditions. 

There is absolutely no warranty for GDB. Type 
"show warranty" for details. 

This GDB was configured! as 11 KB6_64-apple- 
darwin".Attaching to process 49243. 

2011-02-22 11:47:25.307 InstaEfnail[49243:207) I'm 
'sleeping and feeling awesorne about it. 


Q] 
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霸 


Reaps Baw 

■V 

Ope 


To send the email, we’re going to use the messaging API. Rather than go into all the 
details of the messaging framework right now, we’ll give you the code you need. As 
you get further in the book, this type of framework will become easy to use. Add the 
bolded code you see below into the appropriate files, and you’ll be ready to go. 


#import <UIKit/UIKit•h> 

#import <MessageUI/MFMailComposeViewController.h> 

Qinterface 工 nstaEmailViewController : UlViewController <UIPickerViewDataSource, 
UlPickerViewDelegate, MFMailComposeViewControllerDelegate> { 

UlPickerView *emailPicker_; 



InstaEmailViewController.h 


#pragma mark - 
^pragma mark Actions 

- (IBAction) sendButtonTapped : (id) sender { 

NSString ^theMessage = [NSString stringWithFormat : @ 〃工 ， m %@ and feeling %@ 
about it .’’， 

[activities objectAtlndex:[emailPicker selectedRowInComponent:0]], 
tfeeMngs. ectAtlndex: [e.a.lP.Cer, ； electedRowInComponent: 1 ]]]; 
NSLog (theMessage); 

if ([MFMailComposeViewController canSendMail]) { 

MFMailComposeViewController* mailController = 

[[MFMailComposeViewController alloc] init]; 

mailController.mailComposeDelegate = self; 

[mailController setSubject: @ "Hello Renee!’’]; 

[mailController setMessageBody : theMessage isHTML:NO]; 

[self presentModalViewController : mailController animated : YES] 

[mailController release]; 

} 

else { 


NSLog(@"%@ 


Sorry, you need to setup mail first !〃） 




InstaEmailViewController.m 
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ready bake code 



k 鄉 9 Baw 

■V 

Cope Cont 



InstaEmailViewController.m 


代 aU，. T 

L c rL ， u_ 一 


a 灼 

a'»\ 


After adcting tkat code，you can 
、— ^ just save ， Luilct，anct go. It will now 

skow up as a prelormattect email! 
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Tesr DriVq 
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iOS cross 




Across 

3. This typically handles the information itself in the app. 

6. This is the document Apple uses to evaluate apps for 
the App Store. 

7. You see this listed in the view and it controls the view. 

9. This component allows for controlled input from several 
selections. 

10. This type of app is typically one screen, and gives you the 
basics with minimal interaction. 

11. These define to which messages the datasource and 
delegate respond. 


Down 

1 ■ This typically contains the logic that controls the flow of 
information in an app. 

2. The best way to figure out what protocols you need to worry 
about is to check the_. 

4. This app type typically involves hierarchical data. 

5. This app type is mostly custom controllers and graphics. 

8. The other name for an *.xib file. 
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iOS app patterns 


9 ^. 


O 


We’ve listed a couple of descriptions of a some different 
apps. Using the app description, sketch out a rough view 
and answer the questions about each one. 


Generic giant button app 

There are several of these currently up for 
sale on the App Store. This app consists of 
pushing a big button and getting some noise 
out of your iPhone. 


What type of app is this? 


What are the main concerns in the HIG 
about this app type? 




Book inventory app 

This app’s mission is to keep a list of the books 
in your library, along with a quick blurb of 
what each is about and the author. 


What type of app is this? 


What are the main concerns in the HIG 
about this app type? 



you are here ► 
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iOS cross solution 



iOS cross Solution 

Flex your vocab skills with this crossword. 



Across 

3. This typically handles the information itself in the app. 
[DATASOURCE] 

6. This is the document apple uses to evaluate apps for the 
App Store. [HUMANINTERFACEGUIDE] 

7. You see this listed in the view and it controls the view. 
[FILESOWNER] 

9. This component allows for controlled input from several 
selections. [PICKER] 

10. This type of app is typically one screen, and gives you the 
basics with minimal interaction. [UTILITY] 

11. These define to which messages the datasource and 
delegate respond. [PROTOCOLS] 


Down 

1 ■ This typically contains the logic that controls the flow of 
information in an app. [DELEGATE] 

2. The best way to figure out what protocols you need to worry 
about is to check the_. [DOCUMENTATION] 

4. This app type typically involves hierarchical data. 
[PRODUCTIVITY] 

5. This app type is mostly custom controllers and graphics. 
[IMMERSIVE] 

8. The other name for an *.xib file. [N 旧 FILE] 
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iOS app patterns 



We’ve listed a couple of descriptions of a some different apps. 
Using the app description, sketch out a rough view and answer 
the questions about each one. 



Generic giant button app 

There are several of these currently up for 
sale on the App Store. This app consists of 
pushing a big button and getting some noise 
out of your iPhone. 


What type of app is this? 


J\y\ immersive 


What are the main concerns in the HIG 
about this app type? 

The bij| Apple dares about is 七 
dorrtvols u p\rovidc m*tcv-r\ally dor\sis*tcr\*t 

experience.” So everythin ddh be dus-tom, bu 七 
i*t ^cds *bo -focused well or^ahiz^d. 




Book inventory app. 

This app’s mission is to keep a list of the books 
in your library, along with a quick blurb of 
what each is about and the author. 


What type of app is this? 

A frodudtivi-ty aff 

What are the main concerns in the HIG 
about this app type? 

The W\6j has mahy more spedi-fid rules dbou*b 
■this app -type, because you’ll be usm^ s-ba^dard 
dorrbrok EACH dorrbrol heeds *bo be 
ou*t -for proper usd^e- 



A^oihcv- \/icv/ -fov- details, y\ttd {p -figuv-c 
oui how -to jei 七 o it- 
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your iOS toolbox 




Your iOS Toolbox 


You’ve got Chapter 2 under 
your belt and now you’ve 
added protocols, delegates, and 
datasources to your toolbox. 




代 S yOYV 


d V 



_\Vf A 咖 一 d 






A a 扒 A 




BULLET POINTS 


■ 


■ 


The picker needs a delegate and data- 
source to work. 

In a picker, each dial is a component. 


. to ^o\s 

,. s a^c ds ^ 

匕二 c, ’ 




P 私 一 - 


'^T 5 ' 3 a ?v ^ ^ ？ 

神 ? - a 


CaW 枷 如 


■ 


In a picker, each item is a row. 

Protocols define the messages your class 
must realize—though some of them might 
be optional. 
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This is /^ChCC, Mike 
9'^l^ichd. 


s 



0 


Ifs so great that Mike and I are 
communicating now! But IVe noticed that 
Mikes starting to sound like he's in a rut, saying 
the same thing over and over again. Is there 
something we need to talk about? 




Sounds like Mike is going 
to need some modifications 
to InstaEmail to keep his 
relationship on solid ground. 


I 
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3 objectlVe-c !0S 

考 


# Email needs variety 



We did a lot in Chapter 2, but what language was that? 

Parts of the code you’ve been writing might look familiar, but it’s time you got a sense of 
what’s really going on under the hood. The iOS SDK comes with great tools that mean 
you don’t need to write code for everything, but you can’t really write apps without learning 
something about the underlying language, including properties, message passing, and 
memory management. Unless you work that out, all your apps will be just default widgets! 
And you want more than just widgets, right? 


this is a new chapter 



renee wants more 


Renee is catching oh …. 

Mike has been diligently using InstaEmail to communicate his feelings, but his 
girlfriend is starting to think something weird is going on. Even for Mike, who 
is a guy who likes his routines, his emails are starting to sound suspicious. 


InstaEmail is working great and is so easy to use! 
But I think Renee is on to me. She said I sound 
like rm in a rut. I need to be able to add some 
variation to my emails or this isn’t going to work 
much longer. 


We need to make some adjustments 
to our InstaEmail design. 

Take a look at the various Ul controls available in 
Interface Builder, and think about what would be a 
quick and easy way for Mike to add to his emails. 
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objective-c for iOS 


Make room for custom mput 

It’s nothing fancy, but Mike could add a little personal flavor to his 
emails with a text field at the start. It means he’ll need to do some 
typing, but in the end his emails will be more unique. 

S 乙 oo 七 tiVis 
s*tu« dov/r\ 

d little. 




Design Magnets 



pH: 


Using what you know from adding the picker and the button, match the 
magnet with the method or file that you’ll need to edit to add the text field. 


O 

o 

o 

❹ 

o 


to InstaEmailViewG ontroller. h. 


to the top of 

InstaEmailViewGontroller.m. 


to the dealloc in 
InstaEmailViewGontroller.m. 


using Interface Builder. 


to the property created in step 
#1, using Interface Builder. 


Create 
datasource 


a 


delegate 


f or the 


and 


notesField 


Add UITextField 

to the view 


Declare the UITextField and a 
property that/ s an IBOutlet 


Add an IBAction for 
the UITextField 
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Design Magnets Solution 

Using what you know from adding the picker and the button, match the 
magnet with the method or file that you’ll need to edit to add the text field. 


o 


Declare the UITextField and a 
property that/ s an IBOutlet 


to InstaEmailViewG ontroller. h. 


@interface InstaEmailViewController : UlViewController 
<UIPickerViewDataSource, UIPickerViewDelegate, 
MFMailComposeViewControllerDelegate> { 

UI Picker View * email Picker ; U IT > . 、州 ―〆 灼乇 


NSArray ^activities ; 
NSArray *feelings_; 

UITextField *notesField 


V^at 从 、 s d ^ 7r o A t c\^t a tlass 

總 ㈣ 一 


@property (nonatomic, retain) IBOutlet UlPickerView *emailPicker; 

©property (nonatomic, retain) IBOutlet UITextField *notesField; 





InstaEmailViewController.h 


0 


Wait a minute. We keep adding 
code to this .h file, but I still don’t 
know what a .h file really does! 
What gives? 


A .h file is a header file. 

It’s where you declare the interface and methods for a class. All 
of the classes we’ve used so far, like UITextField, NS String, and 
NSArray, have header files. Take a minute to look through a couple 
and start thinking about what is happening in those files. 
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Header files describe the interface to your class 


In Objective-G, classes are defined with interfaces in the header file. It’s where you declare whether 
your class inherits from anything, as well as your class’s instance variables, properties, and methods. 




^sss 


@interface InstaEmailViewGontroller : 

UlViewController 

Qproperty (nonatomic , retain) 
IBOutlet UlPickerView ★emailPicker 


InstaEmailViewController.h _ ( IBAction) sen dButtonTapped: (id) sender ； 


%Sharpen your pencil 


Here’s our current InstaEmailViewController.h file. Fill in the 
blanks and explain what each line does. 


^import <UIKit/UIKit•h> 

^import <MessageUI/MFMailComposeViewController•h> 


Qinterface 工 nstaEmailViewController : UlViewController 
<UIPickerViewDataSource, UIPickerViewDelegate, 
MFMailComposeViewControllerDelegate 〉 { 

UlPickerView *emailPicker_; 

NSArray* activities—; 

NSArray* feelings—; . 

UITextFieId *notesFieId—; 


Qproperty (nonatomic, retain) IBOutlet UlPickerView* 
emailPicker; 

Qproperty (nonatomic, retain) IBOutlet UITextField* 
notesField; 


-( 工 BAction) 
-( 工 BAction) 


@end 


sendButtonTapped : (id) sender; 
textFieldDoneEditing : (id) sender; 


3 


InstaEmailViewController.h 
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sharpen solution 


Sharpen your pencil 

Solution 


Here’s our current InstaEmailViewController.h file. Fill in the 
blanks and explain what each line does. 


#import <UIKit/UIKit.h> 

#import <MessageUI/ 
MFMailComposeViewController.h> 


养 impo\rt mdo\rpova*tcs a 妁 。七 her -file 
(almos*t always a headev -file) m*to -this 
-file whch i*t’s dor^piledi. I*t’s used *bo pull m 




#m6ludc, 七 
_一呢膊). " 

仏伙 a u T . SO¥tnC ^ 1 ^ 


classes, dohstarrts, d -fvom o*thev -files. 


r 


’a ^oloh ^hd 4-U^, 

如 W C S 啊 


Objcttwc—C docsr\ *b suffo\r"t 
multiple ’mV^\r’rtai^e … 


md'»6a*bcs >/ou v-c 
^ dedarc a dlass. 

@mterface 工 nstaEmailViewController : Here, we spedi-fy wKai wc mKerit 4o. 

UlViewController <UIPickerViewDataSource A d ^ proto , oU ^ Co ^ ^ 
UI Pi eke rViewDe legate, 

MFMailComposeViewControllerDelegate> { /4hy i 

b ^is 3 。》峰 

^ J 3V 3 心 . P ^ds 

dssscs - 

^ ^ you 3s 


UlPickerView *emailPicker ; 


This is where we C^y\ dedlare mstahde 
variables of our dlass. 


NSArray* activities 」 
NSArray* feelings—; \ 
UITextFieId *notesField—; 


七 )？《 use 鈿 3sic^,sk Rw j°r usccl ^-«s ； Po\vx4-^ 


B 

InstaEmailViewController.h 
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ne d Y 工 sir 


Oy\Cc you^vc closed *thc -field sed*tioh o-f your m*tcv-fade, you 
C^y\ declare properties. 沴 property tells f)bjcd*tive-C *tha*t 
■thcrc will be addessor methods -for the y\/tv\ propc\rty ar\d 
let you use *the ^ r\o*ta*tioh to a^dess *them. 



TV^cse arc ^^7 aUnW-tes； v/cll 



^ ST 二 : U 二七七 丫 

@property (nonatomic, retain) 工 BOutlet UlPickerView* emailPicker 

moMti allots UtrUt ?>Mtr b> _ a ?。？ 冗上 VAcc 咖 

御 ，“ nr? 二么 . 、 

LUes " 命地 “ 仏、 ^' d m ^ 


@property (nonatomic, retain) 工 BOutlet UITextField* notesField; 




丁 wmws s，wCaM • 中 、 ' J) 


These arc -the mrthod dcdlara*tiohs. 


( 工 BAction) sendButtonTapped : (id) sender; 


-( 工 BAction) textFieldDoneEditing:(id) sender; 




^$£St 

events- 



IB/Ut，' method si 9 „aW ^ have ho o^c 

“ type id (M is like a, Objcd ^cuc 
m ，入 otiwo a^rgumch-ts whcv-c Ohc is -the id o^f the 

f hdcv， cvcht that 
t\rig9C\rcd -the Ull. 


@end 


@cv\d ： er\ds your dlass m*tcr-fadc dcdlara*tioh. 



InstaEmailViewController.h 
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Design Magnets Solution (Continued) 


Badk m i\\ai dcs*>^ y/c 

y/CV"C y/ov-k'mj 


Using what you know from adding the picker and the button, match the 
magnet with the method or file that you’ll need to edit to add the text field. 


o 


Declare the UITextField and a 
property that/ s an IBOutlet 


to InstaEmailViewG ontroller. h. 


NSArray *feelings_; 

UITextField *notesField 


InstaEmailViewController.h 


@property (nonatomic, retain) IBOutlet UlPickerView ^emai1Picker; 

©property (nonatomic , retain) IBOutlet UITextField *notesField; 


Add notesField to 
synthesize 


@synthesize emailPicker=emailPicker 

@synthesize notesField=notesField 


to the top of 

InstaEmailViewG ontroller. m. 

- ： aiil：^ sFie,d - thai ^''yWds 


InstaEmailViewController.m 


OK, so if we declared a property in the 
.h file, then adding ©synthesize in the .m file 
must auto-generate some code, right? 


Yes! It generates the getter and setter methods. 

Using @property lets the compiler know we have a property, 
but that’s not enough. Using the @synthesize keyword in the 
implementation files, we can have the compiler auto-generate the 
setter and getter method we talked about earlier. The compiler 
will generate a getter, and, if it’s a readwrite property, a setter and 
implement it based on the @property attributes declared in the .h 
file. So what do the different @property attributes do...? 


O 


\ 
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办 O 办 








Below is a list of the most commonly used property attributes and 
definitions. Match each attribute with its definition. 


recidonly 


retain 


recidwrite 


cgpy 


assign 


W\\cy\ you ⑽ ” 七 . 七 (^ fvppc.viy. ip. rr»odi^iablc by 
people. .Th( ApwP—V. —_ 1 ! 3Chc\ratc a ^ct-tcy ar\d .f 
scitcy*. -for. you. .This.is 七 . dd 私 It . 

W^tY\ youVc dedl'm^ wi-th basid -typcSj, like mts, -floats, 

t{t : The dompi|c\r just a sct*tcy wi*th a simple 

myFidd =■ value This is {\\t default but 

r\o*t.usually.you w^ni ； . 

iVlich youVc dcalmj vyi*th object yajucs. The .49 叫 ? i!?y; 
will .Vfi 多 … .y.#!V^ you *m (well -talk more 

abou-jt A .七 h?. ?.M 

value y/heh d hew OY\t domes m. 


wfhch you do^*t y/3h't i ： b?. 

^>u stil) -field yd{ue badkmg the 

property ； bu*t the dompilcv- wo^-t gchcra'tc a sc*t*t(cr : 


you wah-t *to hold oh to a dopy of some value 
instead o-f -the value itself; -for example, i^P you y/a^-t 
*(x> hojd ohto ah array d^di doh^ y/^*t people {p be 
able {jo dhahjc i*ts doh*te»}ts. af icr -they sc*t. it. This 
schds a dopy message, to ihc value passed *m ; -thch 
keeps -that. 
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who does what solution 


4 - 






recidonly 


Below is a list of the most commonly used property attributes and 
definitions. Match each attribute with its definition. 

• 吵 . 印 .• 七 . 处 ?. 切 .w'odi^iablc by pc op I 

The ^ompilcv- will JC^C\ra*tc d yt*tc\r d)r\d 3 sc*t*tcv -fo\r 
you ； This is -jbhc dc-fault 


retain 


rectdwrite 


㈨ py 


assign 


c. 



youVc dedlm^ — 七卜 bdsid types, like mts, -float ； 
The domfilcv- jus*t d\rca*tcs a sc*t*tcv- wi*th a Simple 
rr, value This is *thc dc^au)fc. 

usually what you y^t 


Wh. 印 . youVe dc3rmg.y/i*th object, values. The. (C ： ompjc)r 

•vyi" value, you pass m (>^^11 *t^lk more about. 

作 !^:— ”.3 i>?. 孕 . 和 .4. please Jthc old value . 孕 … 
Y\t)^i oy\t domes *m. 

you do^^*t people modi-fym^ *tiic pv ； opcy-*ty. 

^ou still *t]Kc i^s*ta^c variable value badki^g 

*thc pV-opc\rty, bu*t *thc dompilev- >WOir/*t jc^cv-a*tc a SC*t*tc\r. 

you wa^-t to hojd o^*to a dopy o-f some value 
ms*tcad of the value.itself -fovr example ； i^F you wa^*t *b> 
hold oir)*b) a\r\ray a^d do^^*t people *to be able ho 
i*b doir\*tcir)-ts a^*tcy* -they sc*t it This sc^ds a (topy 
message t> the value passed m, -thc^ keeps -that 


D 


tKeretar 

)umb 


e no o 

Questions 


How does the compiler know what field to use to hold the 
property value? 

By default, the compiler assumes the property name is the 
same as the field name, however, it doesn’t have to be. We prefer to 
explicitly name them differently so you know when you’re using the 
property versus the field. You can specify the field to use to back a 
property when you @synthesize it like this: 

@synthesize secretString=superSecretField_;. 


What about that nonatomic keyword? 

By default, generated accessors are multithread safe and use 
mutexes when changing a property value. These are considered 
atomic. However, if your class isn’t being used by multiple threads, 
that’s a waste. You can tell the compiler to skip the whole mutex thing 
by declaring your property as nonatomic. Note that just making your 
properties atomic doesn’t mean your whole class is thread safe, so 
be careful here. 
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Auto-generated accessors also handle 
memory management 

Objective-G under iOS doesn’t have a garbage collector and instead uses a mechanism called reference 
counting. That involves keeping up with how many references there are to an object, and only freeing it 
up when the count drops to zero (it’s no longer being used). You can think of this as object-ownership. 

An object can have more than one owner, and as long as it has at least one, it continues to exist. If an 
object doesn’t have any owners left (its retain count hits 0) ， it’s freed and cleaned up. 

When using properties, the compiler handles it for us. The properties we’ve declared so far have all 
used the retain attribute. When the compiler generates a setter for that property, it will properly handle 
memory management for us, like this: 

州 心⑽ Rctam says >/cVc — a” 气 H :— 七 

Qproperty (nonatomic, retain) NSString* secretString; 




synthesize secretString=secretString 







- (NSString*) secretstring 
return secretstring 



oyoYCvt'f 






如 a 


- (void) setSecretString : (NSString*) newValue 
if (newValue != secretString_) { 
[secretstring— release]; 
secretstring = [newValue retain] 






abated sett ^ ^ ^ docs 


ilkiharpen your pencil 




从 c W ? as! 


Write the code that Objective-C generates for each property declaration 
below. Assume each one is backed by a field named myField_. 


Qproperty (nonatomic, readonly) NSString* myField 


2. Qproperty (nonatomic, retain) NSString* myField 


3. @property (nonatomic, assign) NSString* myField 
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sharpen solution 


%Sharpen your pencil 
< Solution 


Below is the code that the compiler will generate for each 
property. Assume each one is backed by a field named myField. 


@property (nonatomic, readonly) NSString* myField 


.nr\y1Ficldi { 
\rc*tuv*h mypicld 


2. @property (nonatomic, retain) NSString* myField 

- 决） rnyFidd { 

\rrtu\rh r^Pield 一； 

} 一 
- (void) sc*tMyPicld ： (hl££br\v\^) 
hcw\/alue { 

i-f (hcw\/aluc • ，二 mypield- 」{ 

Cmypicld_ release]; 

你 yPield_ 二 Chcw\/aluc reta.m]; 


} 


3. Qproperty (nonatomic, assign) NSString* myField 


(NSS'brm^O myField { 
return mypicld 


(void) sc*tMyPicld ： (NSS*t\r'm^) heWaluc 


Be 幻代 with ihis • 哼⑽ 

so whi,c ihis 
woirk, having dS sia h 

ladZ^I ^ ah is ^ ob ^'y 5 


} 


mypield 一 二 r\cw\/alue ； 




yo' 


>u C-3y\ 


almost alv/ays you 


110 Chapter 3 







objective-c for iOS 




I bet that release just lets go of the memory 
that your properties use up, right? 


Yes, but more importantly, it gives up object ownership. 

When you care about an object sticking around, you can take ownership 
of it by sending it a retain message (and remember, an object can have 
multiple owners). By sending an object a release message, you relinquish that 
ownership. If no one else owns the object, it will be cleaned up. Because of 
this, it’s critically important that you don’t send release messages to objects 
you don’t own (that is, objects you haven’t already sent a retain message to). 


There are times when you want to give up ownership of an object, but you need it to stick around 
long enough for someone else to take it over. In those cases, Objective-G has the concept of an 
autorelease pool. This is basically an array of objects that the runtime will call release on after it’s 
finished processing the current event. To put something in the autorelease pool, you simply send it 
the autorelease message (instead of a plain release message): 

[aString autorelease]; 


It will still have the same retain count and stick around, but after the current event loop finishes, it 
will be sent a release message on your behalf. You won’t want to use this all the time because it’s not 
nearly as efficient and releases objects as soon as you’re done with them. It’s not a bad thing to use, 
but it’s better to explicitly retain and release when you can. 


To keep your memory straight you need to 
remember just two things 

Memory management can get pretty hairy in larger apps, so Apple has a couple of rules 
established to keep track of who’s in charge of releasing and retaining when. 




Oh. 



You own objects you create with alloc, new, copy, or mutableCopy. 

If you create an object with alloc, new, copy, or mutableCopy, it will have a retain count of 1, 
and you’re responsible for sending a release when you’re done with the object. You can also 
put the object in the autorelease pool if you want the system to handle sending a release later. 




Assume everything else could go away at the end of the event loop unless you 
take ownership. 

If you get an object by any other means (string formatters, array initializers, etc.), you should 
treat the object as having a retain count of 1 and it will be autoreleased. This means that if 
you want to hang onto that object outside of the method that got the object, you’ll need to take 
ownership by sending it a retain (and a corresponding release later when you’re done with it). 
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memory management up close 



V[e 獅 ry JV[anagetnent j]p Cl^se 


This is some <^P "the rwemov-y 

ma^ajcrwcht Code tha-t Y<0U 
have dl\reddy 


- (void) dealloc 1 

[emailPicker^ release] 

[activities— release]; 

[feelings, release]; 
[notesField^ release] 

[super dealloc ]； 


Memory management is definitely important on iOS, but that doesn’t mean it’s 
complicated. Once you get the hang of a few key principles, you’ll be able to structure 
your app so that it doesn’t leak memory and get you kicked out of the app store. 


When you create an object, it starts with a count of 1, and different things you do can 
raise and lower the count. When the count reaches 0, the object is released and the 
memory is made available. 
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objective-c for iOS 



Determine how many references are left at the end of the chunk of code and whether we have to 
send it a release for each string. 

Final Reference Count 


NSString *first = [[NSString alloc] init]; 


NSString ^second = [[NSString alloc] init]; 
[someStringArray addObject : second]; 


NSString *third = [[NSString alloc] init]; 
[third autorelease]; 


NSString ^fourth = [NSString 

stringWithFormat:@"Do not read %@", Swimming 
with your iPhone by TuMuch Monee"]; 


NSMutableArray ^newArray = [[NSMutableArray alloc] init]; 

NSString *fifth = [[NSString alloc] 
initWithFormat: @"Read this instead : %@〃，''Financing your 
iPhone 4G by Cerius Savar’’]; 

[newArray addObject:fifth]; 

[newArray release]; 


NSString *sixth = [NSString stringWithString:@”Toughie〃]; 

NSArray ^anotherArray = [NSArray 
arrayWithObjects : sixth count:1]; 

NSDictionary *newDictionary = [NSDietionary 
dictionaryWithObjects : sixth forKeys : @ 〃 Toughie 〃 

count:1]; 

NSString *ignoreMe = [sixth retain]; 
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keeping count 


mm 

Exe 
m 


RciSe 

LytiOH 


Determine how many references are left at the end of the chunk of code and whether we have to 
send it a release for each string. 

Final Count 


NSString *first = [[NSString alloc] init]; 


Rc-fcrchde douh*t will be I 
because allod automatically sc*ts 
dour\*t *to I. 


NSString ^second = [[NSString alloc] init]; 

[someStringArray addObj ect : second]; 

v/ill have d dourrt of 

Z a-f*tcv 七 his blodk o-f Codt ： 1 -fy-om 
■the dllod ； 1 -from msc\rtm3 i*t m*to 

Z 七 he arvay. /Ways au*toma*ti^ally take 

ownership o-f i*tcrws added *bo 

NSString *third = [[NSString alloc] init]; 

[third autorelease]; 

This still hds a rc*ta*m douh*t o-f 1 
because *the allod, bu*t is how m 

■the autorclcasc pool, i*t will 

be sch*t a release au*toma*tidally by 
the system later. 

NSString ^fourth = [NSString 

stringWithFormat: @’’Do not read %@", @^Swimming 
with your iPhone by TuMuch Monee’’]; 

1 This will have 3 rrtam dou^-t o-f 1, 

bu*t will be \ y \ *the pool 

because we do〆 七 ovm i 七 （we didr / 七 
yt i*t via ^ y \ dllod ； o\r some 

-form o-f d dopy). 
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Determine how many references are left at the end of the chunk of code and if we have to send 
it a release for each string. 

Final Count 


NSMutableArray ^newArray = [[NSMutableArray 
alloc] init]; 

NSString *fifth = [[NSString alloc] 
initWithFormat:@〃Read this instead : %@〃， 
''Financing your iPhone 4G by Cerius Savar’’]; 

[newArray addObj ect : fifth]; 

[newArray release]; 


NSString *sixth = [NSString 
stringWithString : @ 〃 Toughie〃]; 

NSArray *anotherArray = [NSArray 
arrayWithObjects : sixth count:1]; 

NSDictionary ^newDictionary = 
[NSDictionary dictionaryWithObjects : sixth 
forKeys:@ 〃 Toughie 〃 count:1]; 

NSString *ignoreMe = [sixth retain]; 


will have a re*ta'm dou^-t o-f I ： 

Piv-s-t) i*t yb d dour\*t o-f I -fvom dllod. 

i*t goes *bo Z because takes 

I owhev-ship by a rrta'm ^y\ is 

•msevted. 

Thch i*t goes badk bo I because ^ array y/ill 
stY\d a v-clcasc -to all its items when -the array is 
destroyed. 

w si>cth" s*ta\rb ou*t wi*th du*bo\rdedsed vc*ta'm 
douh*t o-f I -from drca*tioh (ho*tc i*t 

was^-t -fvom allod, so i*t’s au*to\relcascd). 

hU 此 3r\oihe^ rc*ta*m -from i*t *m*(x> *thc 

array, hloie ihe array y/asr / 七 allowed either, so 
i*t will be auiorelcascd, -boo. 

十 Thch or\c more ve 七 3m -fvom did*tior\ary, also 
r\o*t allowed dhd y/ill be au*borelcased. 

Pmally, Bv\ c%plidi*t rc*ta*m... 

So, cvch -though u si>cth” hds d douh*t o-f ^C, 
y/c, the developers, or\ly Y\ttd *to schd oy\c release 
bo u si%*th w a^d lc*t cvev-y-thm^ else dleah up wi*th 
autorclcasc pool. 
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magnets solution 



Design Magnets Solution (Continued) 

Using what you know from adding the picker and the button, match the 
magnet with the method or file that you’ll need to edit to add the text field. 


Declare the UITextField and a 
property that/ s an IBOutlet 


to InstaEmailViewG ontroller.h. 



NSArray *feelings—; 

UITextField *notesField 


InstaEmailViewController.h 


@property (nonatomic, retain) IBOutlet UlPickerView *emailPicker; 

©property (nonatomic, retain) IBOutlet UITextField *notesField; 



Add notesField to 
synthesize 


to the top of 

InstaEmailViewGontroller.m. 



@synthesize emailPicker=emailPicker— 

@synthesize notesField=notesField ^ 


InstaEmailViewController.m 


o 


Add [notesField__ release] 




to the dealloc in 
InstaEmailViewG ontroller. m. 


- (void)dealloc { 

[emailPicker release] 
[activities— release]; 
[feelings release]; 

[notesField 一 release] 

[super dealloc]; 




-to ^ casc 




Create 
data source 


Wic dcm ’ 七 

o\r d 

-for i\\t v\oits -f ield- 

Add an IBAction for 
the UITextField 

delega 


a 


for 


the notes 


Field 
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InstaEmailViewController.m 






















objective-c for iOS 


File's Owner 


Outlets 

emaiIPkker 


notesReld 

n Text Field 

searchDisplayController 

view 

u View 

▼ Referencing Outlets 

dataSource 

n Picker 

delegate 

n Picker 


New Referencing Outlet 
Referencing Outlet Collections 
New Referencing Outlet Collection 
Received Actions 

sendButtonTapped: 寘 Button - Sen... 

Touch Up Inside 


o 


Add UITextField 

to the view 


using Interface Builder. 


To get into this, you’ll need to open up InstaEmailViewGontroller.xib and find the text field 
in the library. Then drag and drop the text field in between the “InstaEmail” label and the 
'Fm .... and feeling …” labels. You’ll also need to put a label that says “Notes” in front of the 
text field. 


iPho. 


m 


^ork 


\ 


E 


InstaEmail - InstaEmailViewController.xib 







InstaEmail 

Notes: 


,，m f 

and feeling... 



Sunnyva 



^i-c\；ck o, -the Fi| e - S 0^ 

以 ㉝ 




回 


Q >U, > InstaEmailViewController.xib (English) File's Owner 


D □ e 


少 o 


▼ Outlets 


(emaiIPkker 


Picker 




I notes Field 


HH 


Text Field 


searchDisplayContraller 


o 


(view 


)—( 


View 




Referencing Outlets 


[dataSource 


Picker 




I delegate 


Picker 


New Referencing Outlet 

Referencing Outlet Collections 

New Referencing Outlet Collection 


o 


o 


Received Actions 


(sendButtonTapped : 


n Button - Send ... 和 ■ 
Touch Up Inside 



D {} ^ ■ 


I |J Objects 


• . I Label - A variably sized amount of 

Laoei statjc text 

Round Rect Button - Intercepts 
touch events and sends an action 
message to a target object when... 



Slider - Displays a continuous range 
of values and allows the selection of 
a single value. 

E Switch - Displays an element 

showing the boolean state of a value. 
Allows tapping the control to... 

Activity Indicator View • Provides 
feedback on the progress of a task or 
process of unknown duration. 


A 


o 


Link the UITextField to 
the IBOutlet 


to the property created in step 
#1, using Interface Builder. 

Save it arut tken 
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test drive 



Tesr DriVq 


Now that everything is saved, go back into Xcode and click Build and Run, and launch 
the Simulator. 


Cl'»6k -to 
v/v -如 a *to 


Cm 


dll. 



Tke UI works! 


^ "t ~⑼ 

V,avc do 

make kc^boavd 

s\\o^ 

-f ield- Cool! 
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objective-c for iOS 



This week’s interview: 

Who are you anyway? 


Head First： Hello Objective-G! Thanks for coming. 

Objective-C: Thanks! It’s great to be here. I’ve 
been getting a lot of attention recently with this 
whole iPhone thing. 

Head First： So you have a pretty strong lineage, 
right? Why don’t you tell us a little about yourself? 

Objective-C: Sure. I’m an object-oriented 
language, so I have classes and objects, but I come 
from strong G roots. My OO concepts come from 
Smalltalk. Really, there’s not much to me. 

Head First： What do you mean you come from G 
roots? 

Objective-C: Well, nearly all of my syntax is just 
like G syntax. For loops, types, pointers, etc. You 
can easily use other G libraries like SQLite with me. 
Things like that. 

Head First： But you’re more than just that, right? 

Objective-C： Oh yeah, definitely. Most obviously, 

I am an OO language, so classes, abstract interfaces 
(which I call protocols), inheritance, etc. all work 
great. 

Head First： So what about memory management? 
Malloc and free like G? 

Objective-C: Well, malloc and free work just 
like they do in G, but I have a really nice memory 
management model for objects. I use reference 
counting. 

Head First： Ah — so you keep track of who’s using 
what? 

Objective-C： Yup. If you want to keep an 


object around, you just tell me you want to retain 
a reference to it. Done with it? Just release your 
reference. When there aren’t any references left, I’ll 
clean up the object and free up the memory for you. 

Head First： Nice. Any other tricks? 

Objective-C： Oh yeah. You know those getter 
and setter methods you need to write for other OO 
languages to wrap fields in a class? Not here. I can 
automatically generate them for you. Not only that, 
you can tell me how you want to handle the memory 
associated with them. Oh, and one of my favorites: 

I can graft new methods onto classes without a 
problem. They’re called categories. 

Head First： Oh, that’s slick. We’re about out of 
time, so just one more question. What’s up with all 
those “NS’’s all over the place, like NS String and 
NSInteger? 

Objective-C： Ah — those are all part of the Cocoa 
Touch framework. I mentioned my strong lineage 
earlier; most of the core classes that people use on 
iOS come from Cocoa Touch, which is a port of 
Cocoa, which came from OpenStep, which came 
from NeXTStep, and that’s where the NS comes 
from. The frameworks are written in Objective-G, 
but they’re frameworks, not really language things. 
When you write for iOS, you’ll be using things like 
that all the time. For example, instead of using 
charts for strings, you usually use NS Strings or 
NSMu table Strings. We all kind of blur together. 

Head First： This is great information! Thanks 
again for coming by, and best of luck with the iPhone! 

Objective-C： No problem. Thanks for having me. 
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no dumb questions 


ihereictre no 。 

Dumb Questi9ns 


What happens if I don’t retain an 
object I’ll need later? 

Most likely, the object’s retain count 
will hit 0 and it will be cleaned up before you 
get to use it. This will crash your application. 
Now here’s the sad part: it might not crash 
your object on the simulator every time. The 
simulator has a lot more memory to work 
with and behaves differently than a real 
iPhone, iPad, or iPod Touch. Everything 
might look great until you put it on your 
device to test it. Then sadness ensues. 

What if I release my object too 
many times? 

Basically the same thing. When the 
reference count hits 0, the object will be 
released and memory will be freed. Sending 
that now-freed memory another release 
message will almost certainly crash your 
application. 

What if my project works on the 
simulator and dies on the real phone? 
Could that be a memory problem? 

Absolutely. Memory on a real device 
is much tighter than on the simulator. We’ll 
talk more about debugging these and using 
Instruments to track memory usage and 
leaks in a later chapter. 

How can I check if I’m managing 
my memory effectively? 

The iOS SDK comes with a great 


memory tool called Instruments that can 
show you how your memory is being used, 
peak memory usage, how fast you’re 
allocating and deallocating it, and possibly 
most importantly, if you’re leaking memory. 

What happens if I set things to nil? 

Well, it depends on what you're setting 
to nil. If it's just a local variable, nothing. The 
variable is now nil, but the memory for the 
object it used to point to is still allocated and 
you’ve almost certainly leaked something. 
Now, if it’s a property, things are probably a 
little different. Read on to the next question. 

Do I have to retain things I want to 
set on my properties? 

No. Well, probably not. That’s what 
the “retain” parameter is on the @property 
declaration. If you put retain there, the 
property will automatically send values 
retains and releases when the property is 
set or cleared. Be careful about clearing 
properties in your dealloc, though. If you 
have a property with a retain parameter 
and it still has a value when your object is 
released, then whatever that property is set 
to hasn’t been freed. You must send the 
instance variable an explicit release in your 
dealloc. 

One more quick note: the automatic retain/ 
release ability of properties only works if you 
use the notation or the generated setters 
and getters. If you explicitly modify the field 
that backs the property, there's nothing the 
property can do about it and it can’t retain/ 
release correctly. 


Doesn’t Objective-C have garbage 
collection like Java or .NET? 

Actually, on the Mac it does. Apple 
didn’t provide garbage collection on 
iOS, however, so you need to fall back to 
reference counting with retain and release. 

What about malloc and free? Can I 
still use them? 

Yes, but not for object types. Malloc 
and free work fine for basic blocks of 
memory as they do in C, but use alloc to 
instantiate classes. 

What’s with that init call that you 
always put after the alloc? 

Objective-C doesn’t have constructors 
like other object-oriented languages do. 
Instead, by convention, you can provide one 
or more init methods. You should always call 
init on any class you allocate, so you almost 
always see them together as [[SomeClass 
alloc] init]. 

How do I know if something retains 
my object, like an array or something? 

Basically, you shouldn’t care. Follow 
the memory rules that say if you got it from 
alloc, new, copy, or mutableCopy, you have 
to send it a release. Otherwise, retain/ 
release it if you want to use it later. Beyond 
that, let the other classes handle their own 
memory management. 
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Put whew Mike's finished typing... 


The textReld works great, 
but how do I get the 
keyboard to go away? 


The keyboard is permanent? 

Go ahead, play with it and try to get the keyboard to go away. 
Return won’t do it, and neither will clicking anywhere else on the 
screen. Not so cool. 


^ BE 欲咖 ㈣ 

讎 Your job is to he {ke arcliitect and plan 
M ^ howAe \eybo^vd needs to behave. Till 
\ in {he pattern diagram below to e^lain 

yAM needs to h 冲 pen to 
make it away! 


LA 1 




_ should the use ^ see ? 



^ i/i 〜 

" CCd Ldoio 

O ew 〜 
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be the architect solution 



BE • 故相 ecf s©]ug©n 

Your job is to he arcliiteet and plan how 
the \eybo^vd needs to behave. Fill in {ke 
^ pattern diagram below to 呀 lain wht 

needs to happen to make it 
away! 






View Controller 








The user Y\ttds bo 
uhdcrs*tahd wha*t bo do 
to make *thc keyboard 
away, so {\\t 

'Wtu\nr\" button \x> say 

U I » 

(XOY\t - 



The \/icy/ Coh*tvollcr 
y\ccds *to receive *thc 

make -the keyboard 30 
a>way. 


Co^vc^o^ V«kc 必，吧 
-to let user 
W«dc 如 kcvboavd art 
a ， s6usscd m A??k s 
TV^cvc avc lots move ； 
w (W’ 七 0 M J 
七 




，s ,9 oih 3 sh 




^ l/icw. 


Provides 



Dumb Quest! 


9 ns 


Why didn’t we have to do anything to make the 
keyboard appear in the first place? 

When the users indicate that they want to interact with 
a specific control, iOS gives that control focus and sets it 
to be the “first responder” to events. When certain controls 
become the first responder, they trigger the keyboard to show 
automatically. 


Let 1 s start 
witk tke View. 
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Customize your UlTcxtFiGld 

In InstaEmailViewGontroller.xib, select Mike’s custom field and 
then open up the Attributes Inspector in the Utilities pane. You can 
specify an initial value of the text in the field (Text); text that the 
field shows in grey if there’s no other text to display (Placeholder) 
left, center, or right Alignment; different Borders, etc. For now, 
you don’t need to add anything for field, so leave these alone. 

Change the label on the return key 


Changing the name of the button in the keyboard (so it’s “done 
instead of the “return”）is another option in the inspector. The 
big thing that changing the label on the button brings to the table 
is that it clearly communicates to the user what to do to make the 
keyboard go away. 

Click on the Return Key pop-up menu and pick Done. 


伽 e a 代加 

说 sow oUk O^cs. 



Watch it! 


Watch out for the HIG! 

Beyond the Text and Placeholder fields, 
changing some of the other options may hurt 
your usability and make Apple unhappy, so 
be careful. 


rteve’s 七 bu-tW -f ov * 



Now，get tire keytoarct to talk to tire View Controller... 
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message passing 

Components that use the keyboard ask it to appear... 

When users click in the text field, iOS gives that control focus and assigns it as “first responder” 
for later events. A component can get focus a number of ways: the users explicitly tap on the 
control, the keyboard is set up so that the Return key moves to the next control they should fill 
out, the application sets some control to explicitly become first responder because of some event, 
etc. What a component does when it becomes the first responder varies by component, however; 
for a UITextField, it asks iOS to display the keyboard. All this chatter between the application 
and components is fundamental to writing an application, and it all happens through message 
passing. 


...and you ask for things by passing messages to other objects 

The idea is that whenever one object (whether that object is your ApplicationDelegate, another 
component, or the GPS in the iPhone) wants some other object to do something, it sends it a 
message. 



OY\t objcd*t *to wi*th 

a^o*thcv- object i*t sc^ds i*t a message- 



[activities objectAtlndex:row] 






Md 〗七 vesfo^ds -to 
W 杯从 c value - 


In Objective-G, you send a message to an object and it responds to that message (basically returning 
a value from a method). The Objective-G runtime turns those messages into method calls on 
objects or classes (in the case of static methods), but get used to thinking about these as messages; 
you’ll see things like “the receiver of this message will...” all over Apple’s documentation. Now, 
let’s use message passing to get rid of the keyboard when the user is done with it. 
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Ask the UlTextField to give up focus 

In order to get the keyboard to go away, we need to tell the text field that the user is done 
with it. We do this by asking the UlTextField to resign its first responder status. 

Sending messages in Objective-G is easy: you list the receiver of the message, the message 
to send, and any arguments you need to pass along. 




the sc^doy,. ° 






[notesField resignFirstResponder ； 

^ TWis is y/V)C\rc you fut actual message, k 

This is -the -/-u our cast, V^avc no so tills »S a 

details y/V^at messages cadV^ co^o^t 
will \respcmd *to. 



Is that how the View is sending 
the View Controller information? 



Yes! Our View Controller can respond to a 
number of messages like sendButtonTapped 
and viewDidLoad. 

You’ve been responding to messages all this time. Now here’s the 
trick: the textField can send a message when the user taps the 
Done button on they keyboard. We just need to tell it that our 
ViewGontroller is interested in knowing when that happens. 



You can pass messages to nil with no obvious problems. 

Objective-C lets you send messages to nil without complaining. If you’re used 
to NullPointerExceptions from other languages, this can make debugging 
tricky. Be careful of uninitialized variables or nil values coming back as other nil 
values when you debug. 
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messages up close 




Handling Messages Up Cl^se 


You’ve been handling messages since Chapter 1, but we really haven’t talked about 
the syntax to make it work. Method declarations go in your header files and the 
implementation goes in the .m. Here are some snippets from our sendButtonTapped 
implementation from InstaEmail. _ C \ / 

— . ，0h M Wi 





@implementation InstaEmailViewController 



you 

iyyc m ^avc^cscs 

七 V^C message ^amcs. 


vn 3 wc 

.essay. TV,e U 

k ^iled a 

孤 … OV C a r d ^ 

be lo^ ay^a Atst^c 


-theve av-c avgumeirb "to youv« 

T 峡 4 llow ihc n, C ss， d e ^ c 

^ ^ ^ % a,d 

^ the lod variable. Addition! 

a^umch-ts get iypes, a h d 
v^v-iablc h^mes, -too. 


- （工 BAction) sendButtonTapped : 

Now I^cthod Code hc\rc- 


(id) sender 


p ma lly, froV.dc tV^c 


mei^odi dctla\rcd m ou\r '» 


K\*tcv-fa^c- 


TL^ u w 

士 ::: 二 以 - 

七 “ 1 r Ass ^eihodX 


TV svy^tax* for dctla— a ^cssa^c 



InstaEmailViewController.m 


126 Chapter 3 













objective-c for iOS 


Messages m Objcctivc-C use named arguments 


In Objective-G, message names tend to be long and descriptive. This really starts to make sense 
when you see arguments tacked on. When you send a message with arguments, the message and 
argument names are all specified. Objective-G messages read more like sentences. Let’s look at a 
method declaration from UIPickerViewDataSource. This method returns the number of rows for a 


given component in a picker view. It’s declared like this: 

^ T 

- (NSInteger)pickerView:(UlPickerView 
owsInComponent:(NSInteger)component; 


Uo6a\ 


灼 awe 



*)pickerView 


Type J sc^ohdT" 

扣士 -y 


Lo ^l o( ^ 

冰 0hd 




numberOfR 




Methods can have internal and external names for arguments; the external name is used when 
sending the message to the receiver. So when something wants to send this message to our delegate, 
it creates a call like this: 


[pickerDelegate 


Mcssay 




pickerView : somePicker 


a ， …七 g t to^A a ， …七 

^ vaWc 

number0fRowsInComponent:2]; 



You keep switching terms back and 
forth between methods and messages. 
Which is it? 

Both are correct, depending on 
your context. In Objective-C, you send 
messages to objects and they respond. The 
Objective-C runtime turns your message 
into a method call, which returns a value. 

So, generally you talk about sending 
some receiver a message, but if you’re 
implementing what it does in response, 
you're implementing a method. 


thereiare no o 

Dumb Questl9ns 


So about those arguments to 
methods...whafs the deal with the name 
before the colon and the one after the 
type? 

In Objective-C, you can have a public 
name and a local name for arguments. The 
public name becomes part of the selector k. 
when someone wants to send that message 
to your object. That’s the name before the 
colon. The name after the type is the local 
variable; this is the name of the variable that 
holds the value. In Objective-C, they don’t 


have to be the same, so you can use a nice 
friendly public name for people when they 
use your class and a convenient local name 
in your code. 


Mov-c ov\ sclct*tov-s m d w>.mu 七 e. 
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message to controller 


Use message passing to tell our 
View Cowtrollcr whew the Powe button 
is pressed 

The UITextField can tell our ViewGontroller when the Done button was 
pressed on the keyboard; we just need to tell it what message to send. We 
can do this with Interface Builder. You’ll need to declare an action in the .h 
file and implement it in the .m file: 


Z2H 




Messages jo'mj 
\\crt beWen 

dor\*tv-ollcv-. 


o 


Add the IBAction to InstaEmailViewController.h. 

Just like we did with the “Send Email” button, go back into Xcode and add this: 



齡 





於七咖 . Tk ' -， say A a 朽 


Here s now 作 w ’p oy ^ d • 七 — InstaEmailViewController.h 

•mstav^c me 七 W ， 63 c A - s 

孙 d 咖 w The 

w (y/W» 6 ^ mca^s a -to somet ^ 


❺ Add the method implementation in InstaEmailViewController.m. 

Now that we have an action that will be called when the Done button is pressed, we just 
need to ask the textField to resign its first responder status and it will hide the keyboard. 

UplcrhCht this just bc-fov-c 
七 he &t3\\ot method ih youv* 

|hs*t^£mai l\/ie len 


Smtc sender is 

v-csij^Fiv-s-tRcspo^dcv* 

ba^k bo it 



TV,c sedev ” 

UlTd^ W . 


InstaEmailViewController.m 
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Almost tkere, we just need to wire it up •“ 
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Connect the UITextField event in the editor. 

Now that the actions are declared and implemented, go back into 
Interface Builder by double-clicking on InstaEmailViewG ontroller.xib. 
If you right-click on the UITextField, you’ll bring up the connections. 


[O 


厂 



Placeholder Placeholder Text 
Background Background Image 


Outlets 
delegate 
Sent Events 
Did End On Exit 



Disabled Disabled Background lm ;|， 

Alignment' =_^_= 


Border Style 


n 


Text Field 


Ip pears 


( 祝 hen editing begins 


default 


n Rle's Oyyne r 
aeMKittonT.. 


Touch Down Repeat 

Touch Drag Enter 

Touch Drag Exit 

Touch Drag Inside 

Touch Drag Outside 

Touch Up Inside 

Touch Up Outside 

Value Changed 

Referencing Outlets 

nates Field n File's Owner 

New Referencing Outlet 

Referencing Outlet Collections 


enable Return Key 


砟 ■ 


liscrete button. 



Text Field - Displays editable text 
and sends an action message to a 
target object when Return is tapped. 

Text 



Slider - Displays a continuous range 
of values and allows the selection of 
a single value. 

Switch - Displays an element 



In the list of events that the UITextField can send, choose the 
“Did End on Exit” event and connect it to the File’s Owner’s 
“textFieldDoneEditing” action we just created. 


£ Oee} - 

_ The UITextField has a number of events it can raise, just like the round 
rectangular button. Take a second and check out the list that’s there. 
Along with the customizing you can do in the Inspector with the field, you can 
wire up different (or even multiple!) responses to interaction with the field. 
Keep it in mind for your own apps. 
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no dumb questions 


tJiereiare no o 

Dumb Questi9ns 


Why did we send the message back 
to the sender in our action and not to our 
notesField property? 

Either one would work fine; they’re 
both references to the same object. We used 
the sender argument because it would work 
regardless of whether we had a property that 
was a reference to our UlTextField. 

You mentioned selectors, but I’m 
still fuzzy on what they are. 

Selectors are unique names for 
methods when Objective-C translates a 
message into an actual method call. It’s 
basically the method name and the names 
of the arguments separated by colons. 

For instance, look at the code using the 


selector pickerView:numberOfRowslnCom 
ponent. You’ll see them show up again in 
later chapters when we do more interface 
connecting in code. For now, Interface 
Builder is handling it for us. 

When we send the 

resignFirstResponder message to sender, 
the sender type is “id”. How does that 
work? 

“id” is an Objective-C type that can 
point to any Objective-C object. It’s like 
a void* in C++. Since Objective-C is a 
dynamically typed language, it’s perfectly 
ok with sending messages to an object of 
type “id”. It will figure out at runtime whether 
or not the object can actually respond to the 
message. 


What happens if an object can’t 
respond to a message? 

You’ll get an exception. This is the 
reason you should use strongly typed 
variables whenever possible—it will generate 
warnings at compile time, not just runtime 
problems. However, there are times when 
generic typing makes a lot of sense, such as 
callback methods when the sender could be 
any number of different objects. 

So seriously, brackets for message 
passing? 

Yes. And indexing arrays. We all just 
have to deal with it. 



Beware of private framework headers 

Sometimes you’ll come across a really 
tempting method that’s not defined in the Apple 
Documentation. Using undocumented APIs will 
get your app rejected from the iTunes store. 


BULLET POINTS - 

■ In Objective-C, you send messages to receivers. The 
runtime maps these to method calls. 

■ Method declarations go in the header (.h) file after the 
closing brace of an interface. 

■ Method implementations go in the implementation (.m) 
file between the (^implementation and the @end. 


■ Method arguments are usually named, and those names 
are used when sending a message. 

■ Arguments can have an internal and external name. 

■ Use a to indicate an instance method; use “+” to 
indicate a static method. 
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TesT DriVq 



It works! Tire 


key toarct goes away 
and you can play 
arounct witk tke text 
lielct anct actct some 
notes now. 


7a^ w do^c 

WbW … 
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custom note is missing 

Where's the custom note? 


You’re ready to try out the custom field with a demo for Mike, but when he puts 
in his custom text and sends his message... 




" 0 ih-fo 

all... 


o 




0 


The custom note doesn’t 
do anything! It*s not going 
to show up in my email. 


灿 output i rpi ~- 

conditions. C ° PVln3M to se ^ the 

3 挪 & 咖 


□ 





You can iix tkis witli no 
problem now tkat you’ve 
gotten tke kang ol events 
anct message passing [•“ 
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BE . 驳相 ecf 

Your job is to be arcliitect and figure out 
how tire TJlTextReld and tire send email 
button need to worl^ f:ogetiier using tire 

View - View Contvollev model. 




View 
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build the email 



BE • ^cjafecf s©]ug©n 

Your job is to he arcMteet and figure out 
f • how tire TJlTextReld and tire Send Email 
button need to worl^ to^eSxev using tire 

View - View Controller model. 




I. Show -typed 七以七 

2*. Commur\id3*tc 
button push 



M\d the email with strings 


We need to incorporate the note text into our email. In order to do that, we’re going to do a little string 
manipulation with the NS String class. You’ve already built a message to create an email, but this time we have 
more text to include. Before you refactor the code to send the email with the new text in it, let’s take a closer look 


at what you did in Chapter 2: 

This stvi h g didh'-t -fvom aWoC,, 

^ ^ 0}r …山 WcCopy, so it，|| b c 

autovclcascd. 


r 


,. 0 d or. N 咖岣 


“ a st at 、 c 二 ，“ at ^ 

, ? \a6cs ^ , as 碑 … a 




NSString* theMessage = [NSString stringWithFormat : @ 〃工 ， m %@ and feeling %@ about it. 


[activities— objectAtlndex:[emailPicker_ selectedRowInComponent:0]], 
[feelings— objectAtlndex:[emailPieker_ selectedRowInComponent:1]]] 
NSLog(@"%@", theMessage) ; - 




•to 七 he C.oy\solc- 
see 七 hese message 


at *bo trtdkt 


Now all you need to do is update this to include the text from the Notes field. Take a look at the magnets on the 
next page and get it working. 


134 Chapter 3 


















objective-c for iOS 



XcoJe Magnets 

You need to modify InstaEmailViewController.m file to add the custom 
field to the message. Using the information you just learned and the 
magnets below, fill in the missing code. 


-( 工 BAction) sendButtonTapped : (id) sender { 

NSString* theMessage = [NSString stringWithFormat :@〃 
I'm %@ and feeling %@ about it.〃. 


[activities— objectAtlndex:[emailPicker_ selectedRowInComponent:0]], 
[feelings— objectAtlndex:[emailPicker_ selectedRowInComponent:1]]]; 
NSLogtheMessage); 
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Xcocte Magnets Solution 

You need to modify InstaEmailViewController.m file to add the custom 
field to the message. Using the information you just learned and the 
magnets below, fill in the missing code. 



InstaEmailViewController.m 


-( 工 BAction) sendButtonTapped : (id) 

NSString* theMessage = [NSString 
I'm %@ and feeling %@ about it.〃. 




sender 



stringWithFormat : @〃 




notesField •text 


[activities objectAtlndex 


[feelings— objectAtlndex:[emailPi 
NSLog theMessage); 


fp 兹兹 
J Wi，1 ^ ^ ^ 




n 


electedRowInComponent:0]] 
selectedRowInComponent:l]]]; 


TV^c ? \s a oycr9b>r, just l«kc m 

Java o, C ++, 如化 T SS,0 ' 

•,S 饫 UC rb -tv.c value, 

。七一冰••七代七_如 setemd . 


r 
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Tqst DriVQ 


Go ahead and build and run the app with the new text code in it. 



J ( 

—……… 1 

1 sleeping 

awesome 

1 eating 

sad 







Wov/ it has dus-to» 

text/ \NOOi! 
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Objective-C cross 

Practice some of your new Objective-C terminology. 



Across 

5. The control with focus has_status. 

6. This incorporates another file. 

7. Unique names for methods after Objective-C translation are 


8. Signals that the compiler will retain the object. 

9. Automatic methods. 

10. This tells the compiler to skip mutexes. 


Down 

1. An array of objects that will be released after the current 
event. 

2. A"+" before a method declaration indicates that it's a 


3. This is sent between objects. 

4. _management is important for iPhone apps. 
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Your Objective-C Toolbox 

You’ve got Chapter 3 under 
your belt and now you’ve added 
Objective-C to your toolbox. 


Attribute 

You want it... 

vcadlw\ri*tc 

W\\tY\ you *thc pvopc\rty h> be modi-fiablc by people- The ^ompilcv- will 

jc^cv-atc a jc*t*tcv- a^d a settev- -fov- you. This is -the de-fault 

v-cado^ly 

W\\cy\ you do^*t wa^*t people modi-fymg *thc p\ropc\rty. Y^u 乙 a 的 S*till 

*thc -field value bddk'm^ -the p\ropc\rty, bu*t *thc ^ompilcv- >woir/*t jc^cv-a*tc B 

settev-. 

dssi^ 

W\\cy\ youVe dedlm^ wrth bdsid -types, like nrrts, -floa*ts, d. The 乙 ompilev 
jus-t ^v-ca*tcs a settev with a simple myPicldl 二 value s-ta-tcmc^t This is -the 
de-fault bu 七 y\o{, usually wha 七 you wa^t 

v-rta'm 

youVe dcdlih^ y/i*th object values. The dompilev- v/ill vc*tam *thc value 
you pass *m a 灼 d v-clcasc *thc old value v/hc 灼 a ^cv/ o^c domes *m. 

dopy 

iVhc 的 you warrt *to hold ov\bo 3 dopy c^f some value ms-tcad o-f *thc value 
i'bd-f- Fov- c^arwplc, i-f you y/a^*t *to hold o^*to 3r\ avvay a 灼 d do^*t v/a^*t 
people *to be able *to 匕 its 匕 ojrrtc 的 *b a-f*tc\r -they sc*t it This se^ds d 
dopy message *to -the value passed \y\, ⑶ keeps 



/^lcmo\ry /Wahagemeh 七 

/ou owh objects you through ah 

hew, dopy, o\r mu-t^blcCopy. 

V^u Y\ttd *to *takc owhC\rshij> of objects 

you get through othc\r i-f you waht 

*to s-tidk av-ouhd by schd'mg a 代 *taih 

message. 

/ou must \rdcasc objedts you owh. 

Assume e 败 y 七 hih 3 else Will be t\t^tA up 
la 七饮 ff^tchd it has a ^ia\^ I 

is ih *thc au*to\rclcasc pool). 
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Objective-C cross Solution 

Practice some of your new Objective-C terminology. 



Across 

5. The control with focus has_status. 

[FIRSTRESPONDER] 

6. This incorporates another file. [IMPORT] 

7. Unique names for methods after Objective-C translation are 
_. [SELECTORS] 

8. Signals that the compiler will retain the object. [RETAIN] 

9. Automatic methods. [@PROPERTIES] 

10. This tells the compiler to skip mutexes. [NONATOMIC] 


Down 

1. An array of objects that will be released after the current 
event. [AUTORELEASEPOOL] 

2. A"+" before a method declaration indicates that it's a 
_■ [STATICMETHOD] 

3. This is sent between objects. [MESSAGE] 

4. _management is important for iPhone apps. 

[MEMORY] 
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4 multiple VieWs 


參 


A table with a view 



Most iOS apps have more than one view. 

We’ve written a cool app with one view, but anyone who’s used a smartphone knows that 
most apps aren’t like that. Some of the more impressive iOS apps out there do a great 
job of working with complex information by using multiple views. We’re going to start with 
navigation controllers and table views, like the kind you see in your Mail and Contacts 
apps. Only we’re going to do it with a twist... 


this is a new chapter 




mix it up 



Sa% ba\rtchdc\r 

at the ttF 


Lounge 



This chapter is about apps with more than one 
view. What views would you need to have for a 
bartending app? 
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multiple views 




UI Design Magnets 

Using the components shown below, lay out the two 
views we’ll be using for the app. 




l/icvz 养 I 




Nav’iybcm 七 le bavs 



W/Tcx-tFicId wi ^ 
( pl^choldc^ text 



^vboa,a gi w l E l R l T l Y M_l 0 


Q 0 QIPQQQ 


W/Tcx-tl/icws 
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UI Design Magnets 
Solution 

Using the components shown below, lay out 
the two views we’ll be using for the app. 




^ ttt s : like ihe 
utto ^ , h d wct 


We ， \Ua\\ •七 
pwV. 




|七 will also 

shoYi youv 


2:44 PM 


Ingredients: 


Lorem ipsum dolor sit er elit 
lamet, consectetaur cillium 
adipisicing pecu, sed do 
eiusmod tempor incididunt ut 


lAlUaV>c\ 


Directions: 


Lorem ipsum dolor sit er elit 
lamet, consectetaur cillium 
adipisicing pecu, sed do 
eiusmod tempor incididunt ut 


W/Tcx-tFicId with 

^ P^eWd 饮 text 


W/7cx*tl/i CW s 


\/icv/ 养 I 


View 养 i 


Sam heeds a lis-t o-f drmk ha^es ar\d *to be able 
*bo look up wha*t’s m Wt\\ also y/ar\*t *bo 

khow how mudh he heeds eddh m$redierrt dhd 
3 r\y *mst\rud*tiohS—s oy \ vodks, y/hc*thc\r 
*bo shake o\r s*ti\r, y/hcr\ *to li^lvt *thm3s oy \ -fire, 
t{,C- So -for our *two views, well pu 七七 he dvmks 
•m a list (\/ic>w 养1), wliCh *taps oh ov\C, 
well show *thc drbdiU (V\t^i 养 Z). 


VcVc y\o*t "to use 

ccfooS^A (or r\ov/—»*ts d 

rc-rcv"cndc aff) 3r\d Sam 
lus*L r\ccds *bo \read … 
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multiple views 


So, how do these views 
fit together? 

Before you pick the template for our bartending app, take 
a minute to look at how you want the user to interact 
with the drink information. We’re going to have a 
scrollable list of drink names, and when the user taps on 
a row, we’ll show the detailed drink information using 
view #2, our detail view. Once our user has seen enough, 
they’re going to want to go back to the drink list. 


y vj.i :: m ■ 

「— 

t\Uc 


Name ： 


哼 edietvts: 




Div-cdtions ： 



IVmk 养 I 


IVmk 养 I 



Dvmk 养 I 





' 逾 



a li s i ^ j / , 



^sev-s 




1102 . 

如 V 、 st. 




se\^ a “ 


vaSCV- 


. 

Below are the templates available for an app. Which do you think we should 
use for DrinkMixer? 


Window-based Application 


Tab Bar Application 


View-based Application □ Utility Application 


I I Split view-based 
Application 


I I OpenGL ES Application □ Navigation-based 

Application 
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working with hierarchical data 


The navigation template pulls multiple views together 


For this app, we’re going to use a Navigation-based 
project. The navigation template comes with a lot 
of functionality built in, including a navigation 
controller, which handles transitions between views 
and the ability to deal with hierarchical data. 
Hierarchical data means there’s layers to it, and each 
view gives you more detail than the previous one. 


CKoosc ^ template for yom new pro)cci: 


TViC bi /“ 七 - ’… ^av'i 

toK\*bvollcv- pvovi 
buttons ， bav-s, ar\d 
View V^is-tov-y >w*»ll keep 

uSCV* w\OVur\^ V*OU^V> 

da*ta y/’rthou 七 ybt … 3 



A 

Lemon Drop : Citron 
vodka, lemon f and_^_ 


sugar 
the rim 
pour inc 
shaker.. 


The 


^vi 9 a-tio h -tcr^plaic helps 
us tor ， ove^ou 9 h hi ⑽南 f 

f, x , s ^ ,h 9 ^ a Wc 
hsh all -the dHhks. 


Firecracker : Wild 
turkey and hot sauce. 
Pour ingredients into 
a rocks glass filled 
with ice. 


丁 he CohtvollcV" 

provides iv-ahsitiohs 
between views, with vcally 
^himatiohs. 


view 


To get started, go into Xcode and 
choose the File—New Project 

option. Choose the Navigation-based 
this! application and name it DrinkMixer. 
Make sure that “Use Gore Data” 




and “Include Unit Tests” are not 
checked. 
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multiple views 


The table view is built m 

The navigation template comes with a navigation controller and a root view 
that the controller displays on startup. That root view is set up with a table 
view by default, and that works great for our app, so we'll keep it that way. A 
table view is typically used for listing items, one of which can then be selected 
for more details about that item. 





Kavigaii 

-template 




The hdviga-tioh 

^o»vtiro||cv- 
Provides a 


The table view 




々 1 Table View 




Cupertino 
Glendale 
Los Angeles 
Palo Alto 


table view fv-ov'idcs 
easy way *to wov-k data- 
|*t s*bav-*b 

stvollablc list (or *bKc 
viev/ o-P youv 七 .’o 灼 . 
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no dumb questions 


If the navigation template is about 
handing lots of views, why does it only 
come with one? 

Most navigation-based applications 
start out with a table view and show detailed 
views from there. The number of detailed 
views, what they look like, etc., are very 
application-specific, so you have to decide 
which views you want and add those views. 
The navigation template doesn’t assume 
anything beyond the initial table view. 

Which built-in apps on iOS use the 
Navigation control? 

Contacts and Mail, which are both 
core iOS apps, use this design. It’s a good 
idea to spend some time with those apps on 
your phone to see how the entire template 
is implemented. For a neat twist, take a look 
at the Messages (SMS) app. That one uses 
a Navigation Controller but frequently starts 



Dumb Questi9ns 

in the “detail” view, showing the last person 
you sent or received a message from. 


On the iPad, Mail uses navigation control, 
too, but it’s part of a split view-based 
application. We’ll get into that more in a 
couple of chapters. 

Q/ The UlTextField looks editable. 
Shouldn't we fix that? 

Maybe. We're going to go on to use 
that field in a few different ways, so think 
about it again at the end of the app in a 
couple of chapters. 


To make it look less editable, you can 
change the font or change the border. 

Do I have to use a table view for my 
root view? 

No, it’s just the most common, since it 
provides a natural way to show an overview 


of a lot of data and have the user drill down 
for more information. Table views are very 
easily customized, too, so some apps that 
might not seem like table views really are, 
like Notes or the iTunes store, for example. 

How does the navigation controller 
relate to view controllers? 

We'll talk a lot more about this in 
a minute, but the Navigation Controller 
coordinates the transition between view 
controllers. Typically, each top-level view 
is backed by a View Controller, and as views 
transition onscreen, the corresponding 
View Controller starts getting events from 
its view. There's a whole view lifecycle that 
we'll work through that lets a View Controller 
know what's going on with its view. 
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multiple views 



TesT DriVq 


Add a title to the main view, and take a look at what your empty table view will 
look like. Open up MainWindow.xib in Interface Builder. 


_ DrinkMixer - MainWindow.xib 
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test drive 




Tesr DriVq 


Add a title to the main view right away, and take a look at what your empty 
table view will look like. Open up MainWindow.xib in Interface Builder. 


一， s 咖一 
add ^ 


. 々 at ⑽ 




Wa\ WtW 


soow 




If you don’t add the title here, you won’t have a back 
button later. 

The navigation controller uses the title of the current view as the 
label in a back button when presenting a second, more detailed view. 
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The Ta^Je View TJp Cl^se - 

Navigation controllers and table views are almost always used together to work with 
hierarchical data. When you selected the navigation-based project as your template, 
Xcode created a different view setup than we’ve used in the past. The template 
includes MainWindow.xib，which has a single UINavigationGontroller in it. That 
controller starts out with a main view, which is a UITableView that is loaded from 
RootViewGontroller.xib (which is actually a subclass of UITableViewGontroller.xib). 





Table View 





Cupertino 
Glendale 
Los Angeles 
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San Diego 
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TW«s 
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RootViewController.xib 
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come together, right now 

A table is a collection of cells 

The UITableView provides a lot of the functionality we need right 
away, but it still needs to know what data we’re actually trying to show 
and what to do when the user interacts with that data. This is where the 
datasource and delegate come in. A table view is easy to customize and is 
set up by the template to talk to the datasource and delegate to see what 
it needs to show, how many rows, what table cells to use, etc. 


l/icw 


l\/\oAt\ 


f 

Table 




Datasource 


Co^vollcv 




n , , Delegate 

, 气， c PH CKapte, 


a 


化 士。"…。 

， W4 0 ,. i[)€}rcs ^ 


views 

SSP — 

,ct,h 9 ^ovjs, ahd 

祕，。他 . a 





California 


Brea 


Burlingame 
Canoga Park 
Carlsbad 


Chula Vista 


Corte Madera 


Costa Mesa 


Emeryville 

^Escondido 


Section Foo 槪 



ay thcr, ou-t a^y way y ou wahi 



vovis) avc m tacM 



一 n : 工 s 二:二 

4 ca f : 二： c 0 岣 一 




Look through some of the apps you have on your device. What are 
some of the most customized table views you can find? Are they using 
sections? Are they grouped? How did they lay out their cells? 


A -table 63^ V^avc 

6oWm“7 
-table u\\^ 
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Below is an excerpt from our updated RootViewGontroller.m file. This is where we create table cells 
and populate them with the drink list information. 



- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView 
return 1; 



// Customize the number of rows in the table view. 

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection 
: (NSInteger)section { 

return [self.drinks count]; 

} ^ Viow settlors wc V^avc a^d now 

v-ows av-c m settlor. 

必 w a 如一々 “ 一心 ii. 「:: m 

// Customize the appearance of ^table view cells. J/ 

一 （UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtlndexPath 


Ucsc methods tell tabic V.cv/ 


(NSIndexPath *)indexPath 


static NSString *CellIdentifier = @ 〃 Cell" 


Table .elU V,ave —; 了巧 ？ 
u \\ U Vcusc, 70 U 63^ fee ^ 7 ouyrC 


[tableView dequeueReusableCellWithldentifier:Celll 


UITableViewCell *cell = 
dentifier]; 

if (cell —= nil) { 

cell = [[[UITableViewCell alloc] initWithStyl 畝 : UITableViewCellStyleDe 
fault reuseldentifier:Cellldentifier] autorelease]; 

see ^ a，e % 心 S 

七 ^ ava,laW 



// Configure the cell. 


|-f avc^t ^ 

available ^ 0>r rt[ASt) 

^11 dveate a <>^ c * 


cell. textLabel. text 

return cell; 


[self.drinks objectAtlndex : indexPath.row]; 


S ^\C dvmk r,ttA b> 
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populate your table view 


tJiereiare no o 

Dumb Questi9ns 


How do cells get into that reusable 
list to begin with? 

The table view handles that. When 
cells scroll off the screen (either the top or 
the bottom), the table view will queue up 
cells that are no longer needed. When it 
asks the datasource for a cell for a particular 


row, you can check that queue of cells to see 
if there are any available for use. 

I don’t understand the cell 
identifier...does it have to be “Cell ”？ 

No — that’s just the default. When 
you do more complex table views, you can 
create custom cell types depending on what 


data you’re trying to display. You use the cell 
identifier to make sure that when you ask 
for a reusable cell, the table view gives you 
back the type you expect. The identifier can 
be anything you want—just make sure you 
have a unique name for each unique cell 
type you use. 


^iharpen your pencil 


It’s time to start displaying some drinks. You’ll need to make 
some modifications to both the RootViewController.h and 
RootViewController.m files. 



Declare the drinks array. 

Using syntax similar to what we used for the picker, declare an array called 
"drinks" in RootViewController.h with the necessary properties declaration. 


❺ 

o 

o 


Implement and populate the array. 

In RootViewController.m, uncomment and expand the viewDidLoad 
method to create the array with the three drinks from the drink list here. 

Tell the table how many rows you have. 

The auto-generated code needs to be modified to tell the table that it will 
have the same number of rows as there are drinks in the array. Modify the 
implementation file under this line: // Customize the number of rows in 
the table view. 

Populate the table cells. 

Implement the code that we talked about in “Table Cell Code Up 
Close” so that the table gets populated with the items from the array. 


I>Hhk List 

Moji*to 
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Wait, memory in iOS is a big deal, right? 
Three drinks is no problem, but what happens 
if we add a whole bunch of drinks? 


You're right. Like everything else on iOS，the 
UlTableView does have to worry about memory. 

So, how does it balance concerns about memory with an 
unknown amount of data to display? It breaks things up into cells. 


Each drink gets its own temporary cell 

The UlTableView only has to display enough data to fill an iPhone 
screen — it doesn’t really matter how much data you might have in total. 
The UlTableView does this by reusing cells that scrolled off the —‘ 



screen. 






v _ ew£ —HtJif 


usev' 

s Oirtnc 
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^ av f 妯么二 
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sharpen your pencil solution 


^harpen your pencil 

Solution 



Declare the 


It’s time to start displaying some drinks. You’ll need to make 
some modifications to both the RootViewController.h and 
RootViewController.m files. 

drinks array 


士 11 伏 cs 
i\,t datasouvdc 

ovo+odol ^ov so 70U dot. t 



Qinterface RootViewController : UITableViewController { 

NSMutableArray* drinks 一； Add the hew dHhks 
} — -- ay. 

©property (nonatomic, retain) NSMutableArray* drinks; 

@end 



味減 一 rr a H 

va，,aWc 仫 a^W^»ate t 

W 减切 广 r 7 ° u 二 


Pcdlavc 

-fov 

i\^t dv'mks avra7. 



RootViewController.h 



RootViewController.m 
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❺ Implement and populate the array. 

In RootViewGontroller.m, uncomment and expand the 
ViewDidLoad method. 


\A/cVc vas\^ 

V>eve smje 

w aWead”_ 
^ awa^ 


- (void)viewDidLoad { 
[super viewDidLoad] 


drinks = [[NSMutableArray alloc] 


initWithObjects : @"Firecracker^ 
nil]; 


@ " Lemon Drop", @ "Mo j i to ’’， 
t 咐 dvmks ^ave 产 




RootViewController.m 



Tell the table how many rows you have. 


TWis used *to ^ 
vcbuvv \ ： 0- 


// Customize the number of rows in the table view. 

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsIn 
Section: (NSInteger) section { rt 七 ells -table v'icv/ 七 1 ^七 

return^[self. drinks count] ; 一 have same humbev* of vows as *tKc 

y^umbev* of i*tcr«s *m dv^mks 3V*V*ay- 


Populate the table cells 


丁 k vtW 

\S s\\o^ 

I 弘 


// Configure the cell. 

cell.textLabel.text = [self.drinks objectAtlndex : indexPath.row] 

return cell; ^ Hcvc, dusWi« *thc it%i *m the tell Vrth i\\t 
} *m-Povmatioy> -fov *tV>C spcdi-f id dvmk y/C r\ttd *to slioy/. 
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a taste of whafs to come 



TesT DriVq 


Now you’re ready to go. Save it and run it, and 
you'll see the three drinks in your app in the 
main view. 



S 6voU, W 


Everything looks great. I’ll just 
email over our complete list—ifs 
40 drinks... 


O 


o 


life 故 . , _ , _' ^ 9 ^ 
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You mentioned the table view’s 
datasource and delegate, but why didn’t 
I have to conform to anything like we did 
with UlPickerView? 

Great catch. Normally you would, 
but the navigation-based template 
we used has already set this up. To 
see what’s happening, look at the 
RootViewController.h file. You’ll see that 
it is a subclass of UlTableViewController, 
and that class conforms to the 
UlTableViewDataSourceProtocol and the 
UlTableViewDelegateProtocol. If you look in 
RootViewController.xib, you’ll see that the 
table view’s datasource and delegate are 
both set to be our RootViewController. If we 
weren’t using a template, you’d have to set 
these up yourself (we’ll revisit this again later 
in the book). 

I noticed we used an 
NSMutableArray. Is that because we 
had to initialize it? 

No—both NSMutableArray and 
NS Array can be initialized with values 
when you create them. We’re using an 
NSMutableArray because we’re going to 
manipulate the contents of this array later. 
We’ll get there in a minute. 

Q/ What’s the nil at the end of the 
drink names when we create the drink 
array? 

NSMutableArray’s initializer takes a 
variable number of arguments. It uses nil to 
know it’s reached the end of the arguments. 
The last element in the array will be the 
value before the nil—nil won’t (and can’t) be 
added to the array. 

Tell me again about that @ symbol 


tliereiare no o 

Dumb Questi9ns 

before our drink names? 

The @ symbol is shorthand for 
creating an NSString. NSArrays store arrays 
of objects, so we need to convert our text 
names (char*s) to NSStrings. We do that by 
putting an @ in front of the text constant. 

When we customized the table 
view cells, we used the cell.textLabel. Are 
there other labels? What’s the difference 
between cell.textLabel and cell.text? 

Before the iPhone 3.0 SDK, there 
was just one label and set of disclosure 
indicators in the default cell, and it was all 
handled by the cell itself. You just set the 
text you wanted on the cell.text property. 
Nearly everyone wanted a little more 
information on the table cells, so in the 
iPhone 3.0 SDK, Apple added a few different 
styles with different label layouts. Once they 
did that, they introduced specific properties 
for the different text areas, like textLabel, 
detailLabel, etc., and deprecated the old 
cell.text property. You shouldn’t use cell.text 
in your apps—Apple will likely remove it 
at some point in the future. We’ll talk more 
about the other labels later in the chapter. 

You mention that we can use 
section headers and footers—how do you 
specify those? 

The datasource is responsible for 
that information, too. There are optional 
methods you can provide that return the title 
for section headers and the title for section 
footers based on the section number. They 
work a lot like our cellForRowAtlndexPath, 
except they only return strings. 

What’s the difference between 
a plain table view and a grouped table 
view? 


The only difference is the appearance. 
In a plain table view, like the one we’re 
using, all the sections touch each other and 
are separated by the section header and 
footer if you have them. In a grouped table 
view, the table view puts space between the 
sections and shows the section header in 
bigger letters. Take a look at your contact list, 
then select a contact. The first view, where 
all of your contacts are listed together and 
separated by letters, is a plain table view. 

The detailed view, where the phone numbers 
are separated from email addresses, etc., is 
a grouped table view. 

So why are you putting 
underscores after instance variables 
again? 

Remember there are really different 
things in play when we talk about instance 
variables and properties. Instance variables 
are the actual attributes that hold data. 

We use 一 's after those names to help 
indicate that those are actually internal 
class information, not really something we 
want other classes poking around with (we 
also mark them as private so the compiler 
enforces that for us). 

Next, we have properties. By declaring 
something as a property, we get the 
ability to use the dot notation. Accessing 
a property through the dot notation gets 
turned into a call to setSomeProperty (…） or 
getSomeProperty (…) ■ Memory management, 
copying values we want copied, etc., are 
all handled in those accessors. To make 
sure we don't accidentally refer to an 
instance variable when we really want the 
functionality of the accessors and vice-versa, 
we name the instance variable with an 
and property without. 
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whafs in a neon geek? 


Just a few more drinks... 
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O 


u — 


This sucks. Can*t we just import 
the list Sam sent us somehow? 


We could, but not the way we’re set up now. 

Since the drinks are populated with an array that’s hardcoded 
into the implementation file, we can’t import anything. 

What would work well is a standardized way to read and 
import data; then we would be able to quickly get that drink 
list loaded. 



There must be a better way to handle this. How can we speed up 
getting 40 drinks in our list? 
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put your data in a plist 

Plists are aw easy way to save 
md load data 

Plist stands for “property list” and has been around for quite a while 
with OS X. In fact, there are a number of plists already in use in 
your application. We’ve already worked with the most important plist, 
DrinkMixer-Info.plist. This is created by Xcode when you first create 
your project, and besides the app icons, it stores things like the main 
nib file to load when the application starts, the application version, and 
more. Xcode can create and edit these plists like any other file. Click on 
DrinkMixer-Info.plist to take a look at what’s inside. 


DrinkMixer 丨 iPho... * :llll 


DrinkMixer - DrinkMixer-Info.plist 


■ritvj 


a n Q A s I 

DrinkMixer 

r □ 1 target. iOS SDK 4.2 

」 DrinkMixer 

h DrinkMixerAppDelegate.h 
[m] DrinkMixerAppDelegate.m 
/v MainWindow.xib 
h RootViewController.h 
m RootViewController.m 
A- RootViewController.xib 
j Supporting Files 

InfoPlist.strings 
h DrinkMixer-Preflx.pch 
m main.m 
► Frameworks 
I Products 



DrinkMixer > DrinkMixer > [^Supporting Files > DrinkMixer-Info.plist No Selection 



Key 

Type 

Value 


Localization native development region 

String 

en 


Bundle display name 

String 

WPRODUCT^NAMEJ 


Executable file O O 

String 

${EXECUTABLE_NAME} 


Icon file 

String 



Bundle identifier 

String 

com.element84.S{PRODUCT_NAME:rfcl034identifier} 

InfoDictionary version 

String 

6.0 


Bundle name 

String 

S{PRODUCT_NAMEJ 


Bundle OS Type code 

String 

APPL 


Bundle versions string, short 

String 

1.0 

av-c oW_ s , 

Bundle creator OS Type code 

String 

7777 

Bundle version 

String 

1.0 


Application requires iPhone environmei 

Boolean 

YES 

*bo Wad- 

Main nib file base name 

String 

MainWindow ^ 

Supported interface orientations 

Array 

(3 items) ^ 





0 払 ⑽ ave less d 
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七 W … laW 
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PuIIMm types can save and load from 
plists automatically 


All of the built-in types we’ve been using, like NS Array and 
NS String, can be loaded or saved from plists automatically. 
They do this through the NS Coding protocol. We can take 
advantage of this and move our drink list out of our source 
code and into a plist. 


， sf 二二二 仏 

—t mstcad … 



RootViewController.m 



Exercise 


O 


Before you import Sam’s list, let’s create a sample plist that’s the same format. We’ll make sure 
we get that working properly, and then pull in Sam’s list. 

Create the empty plist. 

Go back into Xcode and expand the Supporting Files folder. Right- 
click on Resources and select New file^Mac OS X Resource, and 
Property List. Gall the new list DrinkArray.plist. 


❺ 


Format and populate the plist. 

Open up the file using the Open As ^Source Code and change the 
<dict/> to <array/> and save. Then right-click and use the Open 
As^ASCII Property List option. Right-click inside the plist editor 
and click Add Row. You will need three string items. Then you can 
populate the names for the drinks. 




fDvihk Li 

^\ro\ 

/Woji-to 
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exercise solution 




ExegctSe 

SotutlOH 


With the sample list created, we can use it for 
testing before we get the big list. 


o 


Create the empty plist. 

Go back into Xcode and expand the Supporting Files folder. Right-click on 

Resources and select New file—Mac OS X Resource, and Property List. 

Gall the new list DrinkArray.plist. 



Open up the file using the Open As ^Source Code and change the <dict/> 
to <array/> and save. Then right-click and use the Open As^ASCII 
Property List option. Right-click inside the plist editor and click Add Row. 
You will need three string items. Then you can populate the names for the drinks. 

you i*t as the ASCII fv-opev-ty list • 


« o o 




® ▼④ 


DrinkMixer | iPhone 4.3 Sim.. 


DrinkMixer I iPhone 4.3 Sim. 


n ® 厶 e 


m 


_ DrinkMixer 


DrinkMixer 

1 target, iOS SDK 4.3 

一 Classes 

h RootViewController.h 
m RootViewController.m 
h DrinkMixerAppDelegate.h 
m DrinkMixerAppDelegate.m 
— Other Sources 

h DrinkMixer^Prefix.pch 
m main.m 
Resources 

A RootViewController.xib 
^ MainWindow.xib 
[]DrinkMixer-Info.plist 



<?xml version= M l. 0" encoc 
<!D0CTYPE plist PUBLIC "-y 
^pii^t v version= M l. 0"> 

^f7pTlst> 

This is 

plis*t as sou\rdc- 
Change *this 
bo av-v-ay. 




> DrinkMixer 

—J 1 target, iOS SDK 4.3 

▼ Classes 

h RootViewController.h 
[ml RootViewController.m 
h_l DrinkMixerAppDelegate.h 
[mj DrinkMixerAppDelegate.m 

▼ □ Other Sources 

h^! DrinkMixer_Prefix.pch 
m main.m 

▼ Resources 

A RootViewController.xib 
A MainWindow.xib 
Qj DrinkMixer-Info.plist 
DrinkArray.plist 


::::1 < 

DrinkMixer 

Resources [~'| DrinH 

Key 


Type 

New item 


String 1 

New item 

-2 

String 

New item 

- 3 

O O String m 


... m empty flisi 

ar\d sclc^-t u Add Row ” Tb〆 
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Arrays (awd more) have 
built-m support for plists 


Changing the array initialization code to use the plist is remarkably easy. 
Most Cocoa collection types like NS Array and NSDictionary have built-in 
support for serializing to and from a plist. As long as you’re using built-in 
types (like other collections, NS Strings, etc.), you can just ask an array to 
initialize itself from a plist. 


The only piece missing is telling the array which plist to use. To do that, 
we’ll use the project’s resource bundle, which acts as a handle to application- 
specific information and files. Add the bolded code below to your 
RootViewGontroller.m file. 


乙。 Us o^c 沙 st 


- (void) viewDidLoad { app buhdle -Pov- s 

[super viewDidLoad] ; ^ olUr plist 

NSString *path = [ [NSBundle mainBundle] pathForResource : @ A, DrinkArray ; 
ofType : @"plist"]; 

drinks— = [ [NSMutableArray alloc] initWithContentsOfFile :path]; 


售 


rrv 



RootViewController.m 


Tost DriVq 


After you’ve finished up these two things, 
go ahead and build and run. It should look 
the same, with just the three drinks. 



酿 


Once this list works, head over to http://www.headfirstlabs.com/ 
books/hfiphonedev /and download the DrinkArray.plist file. It 
has the complete list of the drinks from the Head First Lounge. 
Drop this in on top of your test plist, rebuild DrinkMixer, and try 
it out! 
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a full drink list 




TesT DriVq 
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Now we just need 
to get that detail view 
all set up, right? 


Creating your detail view 
will complete the app. 

The entire list of drinks is great, 
but Sam still needs to know what 
goes in those views and how to 
make them. That information is 
going to go in the detail view that 
we sketched up earlier. 




. 

How are we going to get from the list to the detail 
view? And how are we going to display the details? 
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a familiar pattern 


Use a detail view to drill down 
into data 


Earlier, we classified DrinkMixer as a productivity app and we chose 
a navigation controller because we have hierarchical data. We have a 
great big list of drinks loaded, but what Sam needs now is the detailed 
information for each drink: what are the ingredients, how do you mix 
them, etc. Now we’ll use that navigation controller to display a more 
detailed view of a drink from the list. 


The standard pattern for table views is that you show more information 
about an item when a user taps on a table cell. We’ll use that to let the 
user select a drink and then show our detailed view. The detail view 


follows the same MVG pattern as our other views. 
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A closer look at the detail view 

We sketched out the detail view earlier — but let's look more 
closely at what we’re about to build. 



W/TcxtFicld for the 

d\rihk 






lY x tO^ CS 屮、 




It will be popula-tcd Wi-th 
Wanr»c- W dhd -the d\rihk 
ih-fo, so wc doy\-i heed a 
label. 


A ^ U cts U 


to 仏 “ wo 杓二 


Carrier 亨 


2:44 PM 




uBtk bu*t*toh 


Ingredients: 


Lorem ipsum dolor sit er el it 
lamet, consectetaur cillium 
adipisicing pecu, sed do 
eiusmod tempor incididunt ut 


I Directions: 


Lorem ipsum dolor sit er el it 
lamet, consectetaur cillium 
adipisicing pecu, sed do 
eiusmod tempor incididunt ut 


Let’s start tuilctingf* 


蠢參 
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create your detail view 



ExeRclSe 


You’ve got the hang of this now. Start building your detail 
view by creating the files and code you'll need, then put it 
together in Interface Builder and wire it up. Get to it! 


o 


❺ 


Create the files you'll need. 

To create the new view, you need a new 氺 .xib file, as 
well as the supporting header and implementation files. 
The file type is a Cocoa Touch Glass type, and it’s a 
UIViewGontroller subclass. 


Lay out the new view in Xcode. 

Use the object library to drag and drop the elements that 
you need and build the view we sketched out earlier. 

Hint: to reserve the space for the navigation controller, just 
bring up the Utilities Panel and choose the Attributes 
Inspector. Under Simulated Metrics, Top Bar, select 
Navigation Controller. That will make sure that you lay 
out your view below the navigation bar. 




Write the code to handle the declarations and outlets 
for the new properties. 

You’ll need to work in both D e tail Vie wG ontroller. h and 
D e tail Vie wG ontroller. m. Gall the new properties nameTextF ield, 
ingredientsTextView，and directionsTextView. Don’t forget to create 
the instance variables then synthesize and release everything. 



Connect the detail view to the new outlets. 

Just like we did for InstaEmail, use Interface Builder to link 
the controls to the properties. 



Make the text fields uneditable. 

Using the inspector, find the checkbox that makes the fields 
uneditable. 
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tJiereiare no ^ 

Dumb Questi9ns 


We keep drawing the datasource, 
view, and View Controller as separate 
things, but then we stick the datasource 
and controller together into the same 
class. What’s going on? 

It's all about the pattern. In general, 
you’ll have a view defined in a xib, a 
View Controller backing it, and a set 
of data it needs to work on. Whether 
these are combined into one class or not 
really depends on the complexity of your 
application. If you’re not using Interface 
Builder, you can go completely off the deep 
end and have your single class create the 
view programmatically. We’ll show more 
of that later in the book. Conceptually, 
however, you still have a view that’s calling 
into the View Controller when things 
happen. Likewise, you usually have one or 
more datasource protocols being realized 
somewhere that are providing data to your 
view. 

Why do we have to move the *.xib 
file into the Resources group? 

You don’t have to, but we recommend 
it to help keep your code organized. Different 


developers use different groups, things like 
“User Interface," “Business Objects,” “Data 
Objects,” etc. Xcode really doesn’t care; it’s 
just important that you know how your code 
is organized and you can find what you’re 
looking for. Reusing a structure that others 
will recognize is a good practice so people 
can pick up your code quickly and you can 
understand their code. We use the templated 
defaults in this book. 

What are other ways to save and 
load data? 

There are quite a few of them. We’ll 
cover the more common ones in this book 
in different projects. The one you're using 
now, plists, is the simplest, but it does limit 
what you can save and load. That doesn’t 
make it bad; if it works for what you need, 
it’s a fine solution—it's just too limited for 
everything. There's a serialization protocol 
called NSCoding that works well for custom 
objects, but can make version migration a 
challenge. iOS supports saving and loading 
to a database using SQLite. This used to 
be the preferred way to go if you had a lot 
of data or needed to search and access it 
without loading it all into memory. However, 
with the iPhone 3.0 SDK (now just iOS), 
Apple introduced Core Data. Core Data is 


a very powerful framework that provides an 
00 wrapper on persistence and has nearly 
all the benefits of using SQLite. It’s definitely 
not trivial to get started, but it’s really 
powerful. We’ll build an app on it later. 

Why didn’t you use a label for the 
name field? 

UlTextFields allow you to have 
placeholder text that appears in the field 
when it’s empty. Rather than using up screen 
space with a Name label, we chose to use 
the placeholder. If the meaning of the text 
shown on the screen is obvious to the user, 
consider using placeholder text. 

So why didn’t we use it for the 
ingredients and directions? 

We could have, but since those contain 
multiple lines of text, we wanted to break 
them up with labels clearly showing what 
they were. Ultimately it's an aesthetic and 
usability decision, not a technical one. 


BULLET POINTS — 

■ Productivity apps work great with 
hierarchical data. 

■ Navigation controllers are a good 
way to manage multiple views. 


■ iOS tables only have one column but 
can render custom cells. 

■ Tables need a datasource and a 
delegate. 

Multiple views usually mean multiple 
*.xib files. 


■ Table views usually go with ■ 

navigation controllers. 
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long exercise solution 



jtPHg Exercise 
SoLutiort 


Here’s all the info for the new detail view. After this, you 
should have a working (but still empty) detail view. 


o 


Choose a template for your new file: 


Create the files you'll need 

We need a new .xib for the detail 
view. To create one from scratch, 
go back into Xcode and click 

on the File^New^New File 

menu option. 

/Wake swrc -that y ou have 
t 乍 Cocoa Wh Class | ihC 

允 ledted uhdev- 



After clicking Next, you can confirm the subclass of 
UIViewGontroller. In our case, we need both the nib and the 
supporting files, so leave the '’With XIB for user interface" box 
checked and click Next. 



One more thing. Xcode will create 
all your files in the DrinkMixer 
group, keeping them with the 
other class files. Name the file 
4 C D rinkD e tail Vie wC on troller. m. ’ ’ 
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Lay out the new view in Xcode. 


如 — 如•今 Co^ollc^or, 

如 S • 麵 lated Mtbr\ts ^To ? Bav-, 一。咖 
/\ 七七 /“ 七 。 I 叫 c 如 … 七 ^ u*blrU”a〜• 

TV^is is h\t saw U|Tc%tF»cld 栎 a 七 w 

used m |ns 七 a6 你 ail. I 七 Aotsr!i sdvoll. 


TW“ ^ M 

put w Naw” 

^\a 6 cV^o\dcv- 


m 3 s ^ 


_DrinkMixer - Dri n k Detai I Vie wControl le r. xi b 


: <o …: 


m 


\ 




E 


f Name 

Ingredients: 

Lorem ip sum dolor sit er el it 
lamet, consectetaur cillium 
adipisicing pecu, sed do eiusmod 
tempor incididunt ut labore et 
do!ore magna aliqua. Ut enim ad 

minim upniam nuifi nnstrnrl 

Directions: 


Lorem ipsum dolor sit er el it —-s 
larnet, consectetaur cillium 
adipisicing pecu, sed do eiusmod 
tempor incididunt ut labore et 
do!ore magna aliqua, Ut enim ad 

minim UAniam nuis nnstrnrl 


m 


s 


: U! ' 

Drink Mixer > r~|Res... > 



View > Text Field - Name 


D O ^ 


^ O 


Text Field 


Text Text 


Placeholder Name 


Background Background Image 

Disabled 


Disabled Background Irm 


Alignment 匕 




□ 

n 


Clear Button Never appears_ t] 

Q Clear when editing begins 


Text Color 



Default 

0 

Helvetica 12.0 

m. 



Min Font Size 


D {} 存圓 



」 C-ji! 




= ■二 I |HM|| 

n ■— 

m 

i 

£15 FI 


s ❿ o 

# 


□ 

_ 

A 

T 


W»s a 
U|TW，w 

like used 

\ y \ •“ 

I 七 does〆 七 

sdvoll- 


<x 
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long exercise solution 



Exe^ctSe 
SoLutioH 


Here’s all the info for the new detail view. After this, you 
should have a working (but still empty) detail view. 


o Write the code to handle the declarations and 
outlets for the new fields. 


#import <UIKit/UIKit•h> 

@interface DrinkDetailViewController : 
©private 

UITextField *nameTextField_; 
UITextView *ingredientsTextView 
UITextView *directionsTextView 


UlViewController { 


©property (nonatomic, 

©property (nonatomic, 
*ingredientsTextView; 

Qproperty (nonatomic, 
*directionsTextView; 

@end 


retain) 

retain) 


IBOutlet UITextField *nameTextField 
IBOutlet UITextView 


retain) IBOutlet UITextView 


DrinkDetailViewController.h 



DrinkDetailViewController.m 
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o File's Owner 

▼ Outlets 

di rectionsTextVi ew m Text View 

ingredientsTextView u Text View 

nameTextField n Text Field - 

searchDisplayController 
view u View 

▼ Referencing Outlets 
New Referencing Outlet 

▼ Referencing Outlet Collections 
New Referencing Outlet Collection 


o Connect the detail view to the new outlets. 

All three outlets — the directionsTextView, the ingredientsTextView, and the nameTextField — need 
to be connected to their control on the new view. 


_ DrinkMixer - DrinkDetailViewController.xib 


4.2 


a 


M 


w 


DrinkMixer Qj > ^ DrinkDetailViewController.xib .> File's Owner 




Name: 

Ingredients: 

Lorem ipsum dolor sit er el it 
-ennsectetaur cillium 
ecu, sed do 
ipor incididunt ut 


dolor sit er elit 
充 ctetaur cillium 
)isicing pecu, sed do 
eiushaod tempor incididunt ut 




■^■^11 m 


□ 


// 


► 1 [T1 > Q > [h] DrinkD... > No Selection | Q 

DrinkDetailViewController.h 
DrinkMixer 

Created by Tracey Pilone on 2/19/11. 
Copyright 2011 _MyCompanyName_ . All 
rights reserved. 


#import <UIKit/UIKit.h> 

@interface DrinkDetailViewController 
UlViewController { 

@private 

UITextField ♦nameTextField_; 
UITextView 本 ingredientsTextView 」 
UITextView 本 directionsTextView : 


@property (nonatomic, retain) IBOutlet 
UITextField ♦nameTextField; 
@property (nonatomic, retain) IBOutlet 
UITextView ♦ingredientsTextView; 
^property (nonatomic, retain) IBOutlet 
UITextView ♦directionsTextView; 


@end 


Use dva^ 


a dvof 

wto 


vow 

todt b> make l'mk. 


II 


暑 f 


DrinkMixer 


>U V ，吵七-吁 

-to see all outlets* 



you are here ► 175 


















































almost there... 


^SS^JL 0 ^ Ex 时 else 

SoLutioH 


o Make the text fields 

un-editable. 

We need to disable both the 
UITextField and the two 
UITextViews to prevent the 
user from making changes. 
Simply click on each field 
and toggle the Enabled or 
Editable checkboxes to off. 

Once those changes are made, 
the keyboard issue goes away, 
because there won’t be one! 



Ingredfenla ： 

Lorcm ipsum dolor sit or i?lit 

lamot, oon&octetauf cilliom 
adipisicing pccu, do 
eiusmod temper incididunl ut 

Directions 

Ltjre m ipsum dolor ail er el it 
lamet, con&ectetaur clllium 
adlpislclrvg pecu. sed do 
elusmod temper incldlduni ut 






Tqst DriVQ 


Build and run your app. You just put in a lot of work, and it’s a good 
time to check for errors. You won't see a difference yet, just the 
drinks list again... 
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We still need to get tkat ctetail view 
to load wken Sam selects a ctrink. 


OK, so I have an 
order for a Boxcar... 
but I still don’t see the 
drink details when I click 
on it. 


ToudV\ nCV*C 


Boxcar 


r^terpen your pencil 


❺ 


o 


When your users browse through the drink information, they’re going to need to switch between 
the list and detail views. Take a few minutes to think about how to do that while keeping the user 
from getting lost. 


o How does the user navigate between views? 


How can we keep track of what view to show? 



How does the detail view know what drink to show? 


o How do you get the user back to the table view? 
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keeping track 


<&Jharpen your pencil 

Solution 


When your users browse through the drink information, they’re going to need to 
switch between our list and detail views. Think about how we do that and keep 
the user from getting lost. 


|n i\\t simula-tov-, 



❶ How does the user navigate between views? 丁心 uscr is ^ on 以 II d the drmk 

七 -they *to see. 

O How can we keep track of what view to show? jK/avigatioh Co^oljcv ； will keep {xack with bafk 

buttons a^d *thc of *thc 

O How does the detail view know what drink to show? Tha-t^s based oy\ -the -table dell *tha*t 

*thc user sclcdis. 

o How do you get the user back to the table view? ^aviga-tioh Co^broWtr supply a badk 

button *tha*t t^v\ yt us badk to {ht rna'm view. 
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Use the Navigation Controller to 
switch between views 

Now that we’ve got the table view populated and the detail view built, 
it’s time to manage moving between the two views. The navigation- 
based template comes preloaded with the functionality we need: 



A view stack for moving between views 

As users move back and forth, you can ask the Navigation 
Controller to display the appropriate view. The Navigation 
Controller keeps track of where the users are and gives them 
buttons to go back. 



A navigation bar for buttons and a title 

The Navigation Controller interacts with the navigation bar 
to display buttons that interact with the view being shown, 
along with a title to help the users know where they are. 



A navigation toolbar for view-specific buttons 

The Navigation Controller can display a toolbar at the 



Nav Controller 


The UINavigationGontroller supports a delegate, called the 
UINavigationG ontrollerDelegate, that gets told when the controller 
is about to switch views, but for DrinkMixer, we won’t need this 
information. Since the views get told when they’re shown and 
hidden, that’s all we need for our app. 


Detail 

View 




Vow we need to gfet tke Tatle View and Vav 
Controller working togetker to display tke detail view. 
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Navigation Controllers maintain a stack of 
View Controllers 

We’ve been dragging the Navigation Controller along since the beginning of this 
project, and now we finally get to put it to use. The Navigation Controller maintains 
a stack of views and displays the one on top. It will also automatically provide a back 
button, as well as the cool slide-in and-out animations. We’re going to talk more 
about the whole Navigation Controller stack in the next chapter, but for now, we’re 
just going to push our new view onto the stack and let the controller take care of the 
rest. We just need to figure out how to get that new view. 



Out ^ 产 v/ 

•,s dvea-bed , 』 
use 从 c 

Co^volicv- 

七 ov\*to 


Drink 

Table 


laoie 

View 






View Controller 



like, 

l^ojs , ow was sele ^Jh e dd* w 
delete -etw js 

^ dalled, ou, m 

(i^c delete) v^ecds {o trtait a^d 

_ ^ \/心 Co^ollcr. 





Here's where things get interesting: our RootViewController is our 
delegate, so it needs to hand off control to a new View Controller 
to push the detail view onto the screen. How do you think we 
should handle that? 
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Instantiate a View Controller like any other class 

The only piece left to create is the View Controller for the detail view. Instantiating a View 
Controller is no different than instantiating any other class, with the exception that you can pass 
in the nib file it should load its view from: 


[[DrinkDetailViewController alloc] initWithNibName : Q^DrinkDetailView 
Controller" bundle : nil]; 

Once we’ve created the detail View Controller, we’ll ask the NavigationGontroller to push the 
new View Controller onto the view stack. Let’s put all of this together by implementing the 
callback in the delegate and creating the new View Controller to push onto the stack: 


#import ''RootViewController • h" 

#import ''DrinkDetailViewController. h ; 




Smtcwc’rc — 十〒如 

^ Co^ollcv, v/c 
\Mt ^cadcyr. 


#pragma mark - 
#pragma mark Table view 


Y ou V^avc tW«s aWcadv 

Parted, 〆 说如⑽ 七 叫 

delegate dclc^3*tc £-3llb3dk 一 

七 ells us voy/ (dv*mk) >wds sclcd*tcd- 




- (void)tableView:(UITableView *)tableView didSelectRowAtlndexPath:(NSIndexPath *) 

indexPath { ^ - . kWb 如如 

DrinkDetailViewController ^detailViewController = 

[[DrinkDetailViewController alloc] initWithNibName: @〃DrinkDetailViewControll 

er 〃 bundle : nil]; 


// 


// Pass the selected object to the new view controller. 

[self.navigationController pushViewController : detailViewController 

...七一 Vb o 山七 ^ 

v^av^a*b>ov\ s*ta 6 k. 


animated:YES]; 

[DrinkDetailViewController release]; 


j hfa>^aW Co^ollcv 




in 


RootViewController.m 


Let’s try tkis out … 
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the nav controller in action 




TesT DriVq 


Now that both views can talk to each other, go ahead 
and build and run. 


Tap *to wake 
dc-ta'il towc up. 



Tv-v 七 c % 七 

hclds - 七 ^ c 、 ⑽ Ycfoo^cA 
because 七 ㈣’ 代⑽七 cd'ixaWc. 
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O 



So, now we can get to the detail view 
from the drink list, but there areiVt 
any details in there. We don’t have 
that info in our plist, do we? 


Yep, we’ve outgrown our array. 

All that’s left is to get the ingredients and 
directions in the detail view, and we’ll have a 
bartender’s brain. To save you from having to type 
in the ingredients and directions, we put together 
a new file with all the extra information. The 
problem is we can’t just jam that information into 
an array. To add the drink details to this version, 
we need a different data model. 


i^harpen your pencil 


Which options below are possible ways to load the drink data? 


Create a database with drink information _ Use dictionaries in our plist to hold the drink details 

Use an XML file to hold the drink details ~ Create multiple arrays in our plist 


Which of these options is the best for DrinkMixer? Why? 
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dictionaries store key-value pairs 

- ^iharpen your pencil 

Solution 


Which options below are possible ways to load the drink data? 




Create a database with drink information 


Use an XML file to hold the drink details 


( 

’ 胃 k 〜胃 C TTU 十 i» I 

Use dictionaries in our plist to hold the drink details 


ov " ^ 





theh add P^si h g Code. 


a 


have 


Create multiple arrays in our plist 尺 

TW,s ,s feaaall 7 如讀违 七 11 如寸。价 

V,avc -to -akc su,e 十 lc 

Uf -bo keep a sm^lc d^r'mk stvai^ht. 


Which of these options is the best for DrinkMixer? Why? Smdc wc already have Code written that 
uses plis*b, wc ddh our plist *bo have dh array did*tioha\rics *ms*tcad <^f array 

s^v-mjs y/ithou*t 3 lo*t o-f c-f^o\rt ； This y/ay yit doh^ Kaye to ih*jt^odudc S6JL or *m*to ou\r 

>y^.d?. j.9?c ou*t ov\ the ，女 . 切 pi”3 •孕 .ddicl both S6^L ahd 

]X/y)L- dould ^ivc us. S}V)Ct this is a smal|e\r pvrojed-t ； wcVc *(x> wi*th .dictionaries. 


dictionaries store mformatiow 


as key - value pairs 

Our current drink plist is just a single array of 
drink names. That worked great for populating 
the table view with just drink names, but 
doesn’t help us at all with drink details. For this 
plist, instead of an array of strings, we created 
an array of dictionaries. Within each 
dictionary are three keys: name, ingredients, 
and directions. Each of these have string 
values with the corresponding information. 
Since NSDictionary adopts the NS Coding 
protocol, it can be saved and loaded in plists 
just like our basic array from before. 



^ ^ n 


OTtnlcMixer 


n *-p/ist 
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iiereiare no o 

Dumb Questi9ns 


You keep talking about NSCoding. What is that? 

NSCoding is a protocol that provides an API for encoding and 
decoding objects. A lot of the basic container types like NS Array 
NSDictionary conform to this protocol; that’s why we can serialize 
them in and out of a plist. You can conform to this protocol on your 
own custom objects as well. For more information about NSCoding, 
see the Apple documentation. 


Q/ Where did the back button in the detail view come from? 
We didn’t do that... 

It’s automatic functionality that comes with the Navigation 
Controller. When you added a title for the main view, the Navigation 
Controller kept track of that name as part of the view stack for 
navigation, and added a back button with the title in it. So yeah, you 
did do that! 




Ope 


Go back to http://www.headfirstlabs. com/books/hfiphonedev/ 
and download DrinksDirections.plist. It has a different name, 
so you'll need to make a couple of quick modifications. 



Open up the new plist in Xcode (again, in the resources directory), and 
look at what it comes with — all that data is ready to go! 



Go into the code and change the references from DrinkArray to 
DrinksD ire ctions. 




Tqst DriVQ 


Build and run the application, but you should pay close attention. (Umm, not that we think 
anything bad is going to happen, just, well, because...) 
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uh oh... 




TesT DriVq 



186 Chapter 4 





multiple views 


Pebuggiwg — the dark side of 
iOS development 

Something has gone wrong, but honestly, this is a 
pretty normal part of the development process. There 
are lots of things that could cause our application to 
crash, so we need to figure out what the problem is. 


Warnings can help find problems first 

In general, if your application doesn’t build, Xcode won’t 
launch it — but that’s not true for warnings. Xcode will 
happily compile and run an application with warnings 
and your only indication will be a little yellow yield signs 
in the gutter of the Xcode editor. Two minutes spent 
investigating a warning can save hours of debugging time 
later. 


T ^/ll also sh ow 
； h the ^ 

ihc cdi ^ wihdow. 



；\\ see 


c yyOV- 





^_] 




They Will a\>\>cav- m i\\t 

Code 



Gee} Bits - 

Some common warning culprits: 



Now that iOS 4.3 is out, code that uses deprecated 
2.0 or 3.0 properties triggers warnings. 



Sending a message to an object that it doesn’t claim 
to understand (from a typo or an autocompletion 
error) will trigger warnings. Your app will compile, 
but will likely end up in a runtime exception when 
that code is executed. 


That’s not our problem, though: at this point our code is (at least it 
should be) warning and compile-error-free. The good news is that when 
an app crashes in the Simulator, it doesn’t go away completely (like it 
would on a real device). Xcode stops the app right before the OS would 
normally shut it down. Let’s use that to see what’s going on. 

Time lor some cteLugging... 
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start with the console 


First stop on your debugging 
advcwturc: the console 

We need to figure out why our app crashed, and thankfully, Xcode 
has a lot of strong debugging capabilities. For now we’re just going 
to look at the information it gave us about the crash, but later in the 
book, we’ll talk about some of the more advanced debugging features. 


Since you ran the program in the simulator, Xcode is going to bring 
up the debugging pane at the bottom of the editor. You’ll probably 
want to resize it to make the log easier to review. 


« O O 


_ DrinkMixer • RootViewController.m 


DrinkMixer I iPh 


a 


■ 目 ■ □ I 冈 I ■ ■■■■ n 1 ■ 


il R ® A •=• 


P 


DrinkMixer ftJ DrinkMixer |m RootViewController.m tSl -viewDidLoad 


By Queue 


^ Thread 1 

只 com.apple.main-thread 

□ 0 kill 


□ 13 

□ is 


(UlLabe! setText: 


15 -[UITableView(UITableViewlnterr 

□ 35 UlApplicationMain 

Q 36 main 

- Thread 2 

“ com.apple.libdispatch-manager 


Thread 3 


Thread 4 WebThread 




// Customize the number of sections in the table view. 

- (NSInteger) numberOfSectionsInTableView: (UITableView ♦)tableView 

{ 

return 1; 

> 

- (NSInteger )tableView: (UITableView tableView numberOfRowsInSection: (NSInteger) section 

{ 

return [self .drinks count] ; 

> 

// Customize the appearance of table view cells. 

- (UITableViewCell ♦JtableView: (UITableView tableView cellForRowAtlndexPath: (NSIndexPath ♦) 
indexPath 

static NSString ♦Cellldentifier = @"Cell M ; 

UITableViewCell ♦cell = [tableView dequeueReusableCellWithldentifier: Cellldentifier]; 
if (cell == nil) { 

cell = [[ [UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault 
reuseldentifier: Cellldentifier] autorelease] ; 

> 

// Configure the cell. 

cell. textLabel.text = [self .drinks objectAtIndex: indexPath.row]; 
return cell; 


Thread 1: Program received signal: "SICABRT. 




O 土 £ DrinkMixer > || Thread 1 14 -[RootViewController tableView:cellForRowAtlndexPath:] 


Local t 


A 


All Output i 


Clear 


□ H □ 


► [ self = (RootViewController *) Ox4e2d2cO 
□ _cmd = (struct objc_selector *) 0x43 Id5f 

► [ tableView =» (UITableView *) Ox582ceOO 

► I indexPath = (NSIndexPath *) 0x4b2elf0 

► [ cell = (UITableViewCell *) 0x4b2e710 

► II Cellldentifier ■ (NSCFString *) 0x4790 Cell 

d °^ us ^ <>u^ 5pp 


ra i — € 

- n - 






*Oh, 


it under certain conditions. 

Type "show copying" to see the conditions. 

There is absolutely no warranty for GDB. Type 
"show warranty “ for details. 

This GDB was configured as "x86 一 64_apple - 
il mi i I>mi ill i In >i ipi i|i|l I y 1 1 ^iiil I nl ( all 
Attaching to process 36919. 

2011-02-21 14:10:42.322 DrinkMixer[36919 :； 

[_NSCFDictionary isEqualToString:j : unrecognised 
selector sent to instance 0x4e30650 
2011-02-21 14:10:42.361 DrinkMixer[36919:207) 料 * 
Terminating app due to uncaught exception 
'NSInvalidArgumentException ' 9 reason: 

* _NSCFDictionary isEqualToString: ] : unrecogmz^ 
^ctor sent to instance 0x4e30650' 

*** Cat^fe^ai：k at first throw: 

0 CoreFoundation 

0x00da9be9 _exceptionPreprocess + 185 
1 libobic.A.dylib 


n 


oJf uf m 3 set ⑽ d... 
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Interact with your application while 
ifs n/wwiwg 


Xcode 4 is a very powerful debugging tool. Some of the best 
debugging techniques involve well-placed logging messages using 
NSLog(...). This information is printed into the console and can 
help you diagnose problems quickly. The console isn’t just read-only, 
though; it is your window into your running application. We’ll see log 


messages displayed in the console, and when your application hits a 
breakpoint, you’ll be placed at the console prompt. From there you 
can use debugging commands like print, continue, where, up, 
and down to inspect the state of your application. 


TV^C cov\so\t is attuallY 

adb (卿 d —— p 。 州?七:？ 

^av-lv all k 代 . 


And when if s about to stop running 


In this case, we’re dealing with a nearly dead application, but the idea is the 
same. Since DrinkMixer has crashed, Xcode provides you with the basic 
information of what went wrong. In our case, an “unrecognized selector” was 
sent to an object. Remember that a selector is basically a method call — it 
means that some code is trying to invoke methods on an object and those methods 


don’t exist. 


- [Ro otVi ewControlkr viewDid Loa^3 
Debugger Output i ^ 




tlear ) □ Si □ 


GNU gdb 6.3.50-20050B15 (Apple version gdb-151B) 
(Thu Jan 27 03:34:47 UTC 2011) 

Copyright 2004 Free Software Foundation, Inc. 

GDB is free software, covered by the GNU General 
re j.-. Public License, and you are 

welcome to change it and/or distribute copies of it 
under certain conditions. 

Type "show copying" to see the conditions. 

There is absolutely no warranty for GDB. Type 
"show warranty 11 for details. 

This GDB was configured as M KB6_64-apple- 
darwini 11 ■ sharedlibrary apply-load-ruLes all 
Attaching to process 37030. 

Pending breakpoint I - ""RootViewController.in":19" 
resolved 

Current language : auto; currently obj ective-c 

(gdb)' 


~f<> S CC this output, you’ll 
-to select "Dcbuggcv- 
Output -P\rorw this dv-op— 
dovm box. 


But Xcocte doesn’t stop at tke command line. It 
Iras a full GUI ctetugfgfer tuilt rigfkt in. Let’s 

take a look 參參參 
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breaking it down 


Xcode supports you after your 
app breaks, too 

So far we’ve used Xcode to write code and compile and launch our 
applications. Its usefulness doesn’t stop once we hit the “Build and 
Debug” button. First, we can set breakpoints in our code to let us 
keep an eye on what’s going on. Simply click in the gutter next to 
the line where you want to set a breakpoint. Xcode will put a small 
blue arrow next to the line and when your application gets to that 
line of code, it will stop and let you poke around using the console. 

TVis sy/'itdV^ 


bv-cakfo'm*b av-c ov\ or v\oh 


Out sosay a Wcakfomt ><^odc v/ill msevt Step 

S-bcf Ovc\r, Ccmtmue ， and Pcbujjcv buttons to let 

you y/dlk youv todc- 



Slicte tke scrutter all tke way to tire rigfkt 
to see tke full stack from tke app … 
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multiple views 


The Xcode debugger shows you the state 
of your application 

The debugger shows your code and also adds a stack view and a window 
to inspect variables and memory. When you click on a stack frame, Xcode 
will show you the line of code associated with that frame and set up the 
corresponding local variables. There isn’t anything in the debugger window 
you couldn’t do with the console, but this provides a nice GUI on top of it. 




« o o 

® ▼④ [ DrinkMixer 


[_J DrinkMixer - RootViewController.m 


□ 


■ 目 _ 叨1冈1 ■■■■■nl 匿 


n n ® 厶 ee 


m 


DrinkMixer DrinkMixer [m] RootViewController.m Q -viewDidLoad 




M 


By Queue 

Thread 1 

com.apple.main-thread 


3 0 -[RootVIewController viewDidLoad] 

1 -[UlViewController view) 
n 2 -[UlViewController nextResponder] 

I"! 3 -[UlResponder _containsResponder:) 

4 -[UINavigationController defaultFirst.. 
I"! 5 -[UIResponder(lnternal) —deepestDef.. 
n 6 -[UIResponder(lnternal) _deepestDef.. 
Hi 7 -[UIResponder(lnternal) _promoteDe.. 


// Copyright 2011 — MyCompanyName_ . All rights reserved. 

// 

#import "RootViewController.h" 

#import "DrinkDetailViewController . h M 

^implementation RootViewController 
^synthesize drinks=drinks_; 

- (void) viewDidLoad 

{ 

[super viewDidLoad] ; 

NSString ^path = [ [NSBundle mainBundle] pathForResource:@"DrinksDirectionsf' ofType:@"plist" ]; 
drinks_ = [ [NSMutableArray alloc] initWithContentsOf Fi le: path] ; Thread 1: Stopped at breakpoint : 


-[UlApplication _calllnitializationDeL 
I - [UlApplication _runWithURL:^flo. 
-[UlApplication handleEvenl^ith 
-[UlApplication sendEym：] 
_UIApplicationHand^Event 
Pu rple Eve ntCaJp^ck 
_CFRUNp»tfp_IS_CALUNC_OUT_T. 
fun Loo pDoSou reel 
_CFRunLoopRun 
CFRunLoopRunSpecific 
CFRunLoopRunlnMode 
I - [UlApplication _run] 
UlApplicationMain 
main 


( void) viewWillAppear:( BOOL) animated 
[super viewV/illAppear: animated]; 

( void) viewDidAppear:( BOOL) animate 
[super viewDidADp^^fTaniinated]; 


Co^tmuc bu-bWs to let 
vou v/alk 70 UV todc- 




♦ « > 


£ ♦ DrinkMixer ) |l Thread 1 ) □ 0 -(RootViewController viewDidLoad] 


Local 




► C self = (RootViewController *) 0x4b47bc0 
□ _cmd = (struct objc_selector *) 0x43849e 

► [ objc_super = (struct _objc_super) {•••} 

► C path = (UINavigationController *) 0x4b47650 Variable /.. 


)<todc siiov/s you you\r aff s 
variables global 
•m tins 


Debugger Output i 1 Clear C 'E3 Cl 

GNU gdb 6.3.50-20050815 (Apple version gdb-1518} 
(Thu Jan 27 08:34:47 UTC 2011) 

Copyright 2004 Free Software Foundation, Inc. 

GDB is free software, covered by the GNU General 
Public License, and you are 

welcome to change it and/or distribute copies of it 
under certain conditions. 

Type "show copying" to see the conditions. 

There is absolutely no warranty for GDB. Type 
••show warranty., for details. 

This GDB was configured as "x86_64-apple- 
darwin".sharedlibrary apply-load-rules all 
Attaching to process 37080. 

Pending breakpoint 1 - ""RootViewController.m" : 19" 
resolved 

Current language: auto; currently objective-c 


a 


o 




Tesr DriVq 


Since we know that we’re having a problem near the array, 
try setting a breakpoint on the line that creates the array. 
Then build and run the app again and see what happens. 
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loading the array isn’t the problem 



TesT DriVq 


When you step over the breakpoint at the point where you load the array, everything 
is OK: J 



But kit continue and. 


To set a , 
Weak? 。， 此 7 ou， '' 
r^ttA ^'» 6 k m 
i\^t y 七 W, ^ 




(>)(■) I OrmkMi^r I ： | 


_ firiLnl.Mixnr ftniilVii'wC'iinliOilln.irni 

ChlnkNttKff I 「 1 Prink Ming < ]m[ imVIfi^i^crolkr.in • d -irtfwDldLfi^d 


m 


ToIa.B 




// r 3 qh t 'fi b 3 ni'^^afpnnvrla 


■ All 


gh I 


HV Qu«IM 


,t '3 I ； 


，TJ， 


Ihirjii 


fiapori: n RDfltVle«<ont rot Itr^ h" 

Fiip«rt "DrLn 明 etailV^fj^aMrolUr ， >h" 


rl IS ，叫 lUbd 9<Ef<a.i:)i 

L4 [TI:-HiVi«vConDr^kr ubteVi^ etl. 

□ 1 \ -[Ul I jliipVii»A^in!E jbivVinvInl prnjll 

□ 35 UL^I^xiton^din 

miLin \ 


I a |： . r -rr ' .i! lv n llc-pl va r^C ufil ■ ^-11 r 

■nvn tihr-i - i 1 r dr inhiLHii' .nk-i : 


\ voa d Vi icnllldLaAd 


Is^upc-r 

MSS I I I rig i pjp Lh ■ I |M\t mri 
•: r ink ■. ■ [ [H hHii 1 .1 h I r>Ar r ■， 


i.i anHur.d I f | p.i I i.M^<L^ur c ip : fD r ankiD j r I I pn ^ ~ a T ] ^>|3— =^ u pl i 挲 

\ Lnc ] in i.l Hs S h^c-nl quE ^0 ^ i Lf>: ajplh ]; 


( v：id I-vIcwppI Limped r: <| Bl jL | dniut-ed 
I tuptr v&«-WWklLApetar :， 


-I il I v i ruv I dnpprn j 1 e j HI ： .. I iinann I rd 
Is up>r wbdlAppf-fer! Miid-c-td|; 


14 - - |RoacViewC««vir-^l^ EibkV^^ 1 ulFofRiHvAiln^xPwiK ] 

CMpue : UW J 

mu gdk ms -'App'ir vrrliii^n qtih 




il Thftia 


1 ■ORftldlvD 1 

■ *) >Qk 4, 3d 零 F 

“ ； ijbleVi€4^^^TjUeV'i«f4 "j DxSaictDD 

，卩 inatuFMh - im^c-^lh "I 

¥■ a • fpr^iiMi&an 

k Q CcM 漏 MlA«r ■ CM^gMrtM 0 k4?1^ 


Oe&u^p WPiie - o«*r U .■: 

fJli.1 Ijlib lApp'lr ^r-kLcn nrlh l 1 ? Jfll 

>|Thii ?? BR: Mi：47 IJTC IH13] 

24P4 Fre? ^ftusf 哲 F^uPrdatInf, 

CiDB i¥ ire^ 9>of twarf-. covfrfd ^ the 明 ij ^tn^rfel 
Public Licefiie, >nd you Are 

Hf IcbK -chan^t kt sn4/br 4ixt ribut-c C4^ies *f 
un^er ccri*a.n to-ndkCiDn^. 

Typ? <-gpyr)ing~ E 0 thi? ^poid L ^ pn^.. 

Th«rrr ^b>^1 l i l afe-f'l ： v np mbt'i dnl y Iqii 1 CJDiR a Type 

U>rf4iAiy r> t^F d^t^ilXT, 

Th-i^ &Ofli wa-p ^ntiqyrcd >% *'».fiB t= 64-*-5p-|ile 
da ruin' 1 i. s.Hd>rtd l l^bra rpc ap>ply*l.«ad«ru lea all 
AtCfechSijrtB to procefi 1^914. 

Current Lan^uaqf -： currentlir at]tctii^e—c 
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multiple views 


nimateaJ; 


• il 、 i 


lixer n Thread 1 


) 0x4eldea0 
-*) Ox431d5f 
\S82bOOO 
*> 0x4e29230 
4e29750 
*) 0x4790 Cell 


All Output C Clear 1~1 il fl 

darwin".sharedlibrary apply-load-rules all 
Attaching to process 37966. 

Pending breakpoint 1 - ,M, RootViewController.m M : 

19" resolved 

Current language: auto; currently objective-c 

2011-02-21 16:01:39.044 DrinkMixer(37966:207] - 
[ — NSCFDictionary isEqualToString:] : unrecognized 
selector sent to instance 9x4elc5c0 
2011-02-21 16:01:39.073 DrinkMixer[37966:207 ] 本林 
Terminating app due to uncaught exception 
a NSInvalidArgumentException 1 9 reason: 

[ — NSCFDictionary isEqualToString:] : unrecognized 
selector sent to instance 0x4elc5c0 1 
本本本 Call stack at first throw: 


0 CoreFoundation 

OxO0da9be9 _exceptionPreprocess ♦ 185 

1 libobjc.A.dylib 
OxOOefe5c2 objc 一 exception_throw ♦ 47 

2 CoreFoundation 


_ DrinkMixer - RootViewController.m 


■ 目 ■ Ell 叼 


□ H] 


a n Q A 


m 


► 


DrinkMixer PH DrinkMixer [m) RootViewController.m Rl -viewDidLoad 


By Queue 


Thread 1 

开 com.apple.main-thread 

0 -[RootViewController viewDidLoad] 

1 - [UlViewController view] 

] 2 - [UlViewController nextResponder] 

1"1 3 - [UlResponder _containsResponder:) 
["1 4 -[UINavigationController defaultFirst.. 
n 5 -[UIResponder(lnternal) 一 deepestDef" 
6 -[UlResponderdnternal) _deepestDef.. 
PI 7 -[UIResponder(lnternal) 一 promoteDe.. 


1"1 9 - [UlApplication _calllnitializationDel.. 
1"1 10 - [UlApplication _runWithURL:paylo.. 
I"1 11 - 【IIIApplication handleEvent.withN.. 
I"! 12 - [UlApplication sendEvent:] 

HI 13 _UIApplicationHandleEvent 

□ 14 PurpleEventCallback 

g 15 一 CFRUNLOOP_IS_CALUNG_OUT_T.. 
0 16 一 CFRunLoopDoSourcel 
IH 17 — CFRunLoopRun 
s 18 CFRunLoopRunSpecific 
s 19 CFRunLoopRunlnMode 

□ 20 -[UlApplication _run] 

I"! 21 UlApplicationMain 
Q 22 main 


S 


o 


// Copyright 2011 — MyCompanyName_ . All rights reserved. 

// 

#import "RootViewController.h" 

#import "DrinkDetailViewController . h M 

@implementation RootViewController 
^synthesize drinks=drinks_; 

- (void) viewDidLoad 

{ 

[super viewDidLoad] ; 

NSString *path = [ [NSBundle mainBund le] pathForResource:@"DrinksDirections[' ofType:@"plist" ]; 
drinks_ * [ [NSMutableArray alloc] initWithContentsOf File: path]; Thread 1 ： Stopped at breakpoint 

> 

- ( void) viewWillAppear: (BOOL) animated 

{ 

[super viewWillAppear: animated]; 


( void) viev/DidAppear: (BOOL) animated 
[super viev/DidAppear: animated]; 


H !► O £ i DrinkMixer |t, Thread 1|o-[RootViewController viewDidLoad 】 


Local 


A 


□ self = (RootViewController *) 0x4b47bc0 
!: _cmd = (struct objc_selector *) 0x43849e 
objc_super = (struct _objc_super) {•••} 
path = (UINavigationController *) 0x4b47650 Variable /... 


Debugger Output t 


Clear 


■□□a 


GNU gdb 6.3.50-20050815 (Apple version gdb-1518) 
(Thu Jan 27 08:34:47 UTC 2011) 

Copyright 2004 Free Software Foundation, Inc. 

GDB is free software, covered by the GNU General 
Public License, and you are 

welcome to change it and/or distribute copies of it 
under certain conditions. 

Type "show copying" to see the conditions. 

There is absolutely no warranty for GDB. Type 
"show warranty" for details. 

This GDB was configured as "x86_64-apple- 
darwin".sharedlibrary apply-load-rules all 
Attaching to process 37080. 

Pending breakpoint 1 - ""RootViewController.m" : 19" 
resolved 

Current language: auto; currently objective-c 


What the heck is going on? 


Our application is crashing, and it’s not at the array loading 
code, so get back into Xcode. It will show you the line that’s 
causing the problem, can you see what’s wrong? 


To te continuecL 


you are here ► 
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multipleviews cross 



MultipleViews cross 

Take what you’ve learned about the Navigation 
Controller and multiple views to fill in the blanks. 



Across 

3. The set of views that the nav controller deals with. 

6. Dictionaries use_to organize data. 

8. The screen that gives you output from the app. 

9. A template that combines a table view and nav controls. 

10. Has cells that need to be customized to work. 


Down 

1. A more versatile way to manage data beyond an array. 

2. DrinkMixer is this type of app. 

4. To use a new class you need to_it. 

5. The @ symbol is shorthand for creating one of these. 
7. A tool in Xcode to help fix broken code. 
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multiple views 



Your iOS Toolbox 


You’ve got Chapter 4 under 
your belt and now you’ve 
added multiple views and the 
Navigation Controller to your toolbox. 


Tables ： 

/\y*C d dollcd-tio^ o-f 6clls. 

Come suf\>o\rb -fov editn^ 
do^*tc^*b> sdvollm^ moVm 9 


㈣ Kf c: 

.柊 a 咖 _ 扣 A 

一二二 〆 a 、 

二厂 


vov/s. 


be dus*bomiz^d so youv dells 
look like more 払 an one doluwm. 


Plists ： 

Piles *tha*t t^y\ be ^v-c^tcd dhd 
edited ih X^odc. 

Suppo\rt Av\rays ahd Didtioh 扣 ics 

oui o*f ihc box. 

/We good 4\r hahdlihg da-ta, but 
have some limi*ta*tiohS—well toMtY 
Aoth 饮 optioh, CoYt Vaia, ih a 
Couple dhap*tc\rs dom'rn^ up. 


^TaWeV^ 

义:二 A 、o 以 

cUc. 



toller: 

/Waih-taihs a view sia^k 4v moviho 
bctwcch view ^oh*t^ollcvs. 

Hasa butUs 

3hd a 

Cah supped ^sio^ ioolbavs at 

■the bot-fcon, of ihc view as heeded. 


)<dodc ： 

Hds a buil*t-m dohsole wi*th 
debu^'m^ dr\d 1033^3 m*fo\n^ 3 *tior\. 

gives you c\r\ro\rs dr\d y/dv-h'm^s ds 
you Compile *bo idch*ti-fy problems. 

Has a buil 七一 m debugger 七 ha 七 allows 
you *bo sc*t b\rcakpo*m*ts ar\d s*tcp 
through the Code *to -f md *the bu^. 
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MultipleViews cross Solution 

Take what you’ve learned about the navigation controller and 
multiple views to fill in the blanks. 



Across 

3. The set of views that the nav controller deals with. 
[VIEWSTACK] 

6. Dictionaries use_to organize data. [KEYS] 

8. The screen that gives you output from the app. [CONSOLE] 

9. A template that combines a table view and nav controls. 
[NAVIGATION] 

10. Has cells that need to be customized to work. [TABLEVIEW] 


Down 

1. A more versatile way to manage data beyond an array. 
[DICTIONARY] 

2. DrinkMixer is this type of app. [PRODUCTIVITY] 

4. To use a new class you need to_it. 

[INSTANTIATE] 

5. The @ symbol is shorthand for creating one of these. 
[NSSRING] 

7. A tool in Xcode to help fix broken code. [DEBUGGER] 
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5 pl!sts and modal Views 



Refining your app 


This soup would be 

even better with the perfect 

cocktail, maybe a Neon Geek. 


So you have this almost-working app... 

That’s the story of every app! You get some functionality working, decide to add something 
else, need to do some refactoring, and respond to some feedback from the App Store. 
Developing an app isn’t griwttys ever a linear process, but there’s a lot to be learned along 
the way. 


this is a new chapter 
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debugging DrinkMixer 


It all started with Sam 


Sam wanted an app to make his bartending work 
easier. You got one up and rolling pretty quick, 
but hit a snag filling in the details for each drink 
because of a plist of dictionaries. 


PrmkMixcr 



D\rihM/Iixe\r has two 
views ： a table view o-p 
d\rihks av\d a detail 

abou-t cadh ihdividual 
d\rihk. 



Manhattan 
Melorti Tr&c 
Mexican Bomb 
Miami Vice 
Mojtto 

M usic City Sun Ml 
Neapolitan 
Neoi^i Geek 
Polo Cocktail 


• 60 


DrinkMixer 



酗 n © A _ 


TiPh^lO 
一 p TTiiiT 


DrinkMixer 


Dri 


斧島 By Queue 
Thread 1 

H com.appie.main-thread 

00 一 ki" 

01 kill5UNIX2003 
Q 2 raise 
□ 3 abort 

04 _gnu„cxx::_verbosegerminate.. 

05 _objc„terminate 

0 6 ]_cxxabivl::_terminate(void (*) 0 ) 

07 _cxxabiv 1 ::_unexpected(void (*) 0 ) 
08 qxx_exception,cleanupL^ nwin - 

09 一 objc_personalityj/0 
目 i 0 ~-lNSObject(NSObject) doesNotR.. 

痛 • ， o • ^ _ 


indexPath 

— Nsstri ;; ㈣ 二 6 二二 _ i 

reuseldentifier 

Cellldentif ier] autorelease ] , 






> 

cel'u't'eirLabeutexfi' Iself.drxnks objectAtlndex-.indexPath. row] ; 

return cell ； 


S »► 


t DrinkMixer 


Local C 


~Q self 


_ 

(RootViewController *) 


Ox. 


Thread 1： Pfognm received signal: -SICABRr, ^ 

.47 UJX 2011' • ■■国 


Wken we last left DrinkMixer, you 
were in tke mictdle ol ctetugging it... 
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plists and modal views 



Anat 娜 y 

a Crash 


DrinkMixer started and ran happily until it hit our breakpoint 
at line 19. The debugger stopped our application and displayed 
the debugging console. By setting a breakpoint in our code, what 
we discovered at the end of Chapter 4 is that before your app 
imported the file, there was no crash; so far so good. 

Let’s walk through loading our plist and make sure that works by 
typing next twice. The first “next” sets up the path to the plist, 
the second one actually loads the data. 


pnate_ … 

no) 

foid HO) 
Jnwin … 

'JotR... 


hctio.. 


> 


rcell ==Vhii) 

cell = [[ [UITableViewCell alloc】 initWithStyle:Ulrt 
Cellldentifier] autorelease] ; 


Le\r!C?wCel\^tyleDefault reusefdentif 




// Configure the cell. 

cell. textLabel.text = [self .drinks objectAtIndex: indexPath. row] ; 
return cell; 


Thread 1: Program recerved signal "SIGABRy. 


H O i i DrinkMixer || Thread 1 14 -(RootViewController tableView:cellForRowAtlndexPath:) 


A 


All Output t 


Clear C 


□ self = (RootViewController *) Ox. 
3 _cmd ■ (struct objc_selector *) 
tableView = (UlTableView *) Ox.. 
Q indexPath = (NSIndexPath *) Ox.. 
B cell = (UITableViewCell *) 0x4b... 
D Cellldentifier = (NSCFString *)... 




GNU gdb 6.3.50-20050815 (Apple version gdb-1518) (Thu Jan 
08:34:47 UTC 2011) 

Copyright 2004 Free Software Foundation, Inc. 

GDB is free software, covered by the GNU General Pub^fc License, 
and you are 

welcome to change it and/or distribute copies of under certain 
conditions. 

Type "show copying" to see the conditions. 

There is absolutely no warranty for GDB. Type/"show warranty" for 
details. 

This GDB was configured as "x86_64-apple-dar/in n •sharedlibrary 
apply-load-rules all 
Attaching to process 91576. 

Pending breakpoint 1 - ""RootViewControll 
Current language: auto; currently objective-c 
(gdb) next 
(gdb) next 

2011-02-26 15:22:16.294 DrinkMixer[91576:207] -[_NSCFDictionary 
isEqualToString:] : unrecognized selector sent to instance 0x4elfOdO 
2011-02-26 15:22:16.313 DrinkMixer[91576:207] Terminating app 
due to uncaught exception ( NSInvalidArgumentException', reason: 

[ — NSCFDictionary isEqualToString:] : unrecognized selector sent to 

instance 0x4elfOd0 a 

*** Call stack at first throw: 


Heve’s y/iicvc i*t 
s-toppcd at 
bvcakpomt Wlc "told 
i\\t dcbu^cv- bo \ti 

I'mcs. 


1 : 19" resolved 


^7 


OUT... 


0 CorePoundation 
— exceptionPreprocess + 185 

1 libobjc.A.dylib 
objc_exception_throw + 47 

2 CorePoundation 
(NSObject) doesNotRecognizeSelector:] 


187 


0x00da9be9 

0x00efe5c2 

0x00dab6fb -[NSObject 


I 七 ^dc i-f： past 

loadihg the 

plis*t ; so lc*t ； s 

let it ^ohtihuc 

'ruhhihj... 


TVis caption tells you i\\ai 一 < 於 0 樣 sele^tov (message) »s b> 

NSCFP^tio^avy-spcti-fitallY ， is6<\ualToS*tv'm3...so y/licvc is It Wor^. 


Loading the plist worked fine; no problems there. The error must be coming after that. 
Let’s have the application continue running and see where it fails. Hit the Continue 
button (or type continue in the console)...and there’s our exception again. Where is 
this actually failing? 


you are here ► 
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CSI iPhone 


Use the debugger to investigate 
the crash 

We can reliably get DrinkMixer to crash, and it doesn’t seem to be our 
plist loading code. Xcode has suspended our application right before 
iOS shuts it down, so we can use the debugger to see exactly what it was 
trying to do before it crashed. 

Switch back to the debugger and take a look at the stack on the left. This 
is the call stack that led to the crash. 


-e’s 

16 k a 七 
t 七 ， wC 
七 k 
asVv TV\c 

odt, V)u*t 
vawc 厶， s 
odt v/c 
N/vo-bc- 


Tk s-top bu-t-toh will 
tcvmihatc youv- appliutioh. 



_ DrinkMixer - RootViewController.m 


DrinkMixer I iPh … 


H II ® 厶 EEE 


m 



MTbI 园 


DrinkMixer DrinkMixer > [m RootViewController.m -viewDidLoad 


By Queue 



^ Thread 1 

、 > com.apple.main-thread 

□ OJdll 
Q 1 killSUNIX2003 
H 2 raise 
Q 3 abort 

El 4 _gnu^cxx::_verbose_terminate 一 … 
H 5 _objc_terminate 

cxxabivl:: — terminate(void (*)0) 
cxxabivl:: 一 unexpected(void (*)0) 
gxx_exception_cleanup(_Unwin... 
objc_personality_vO 
-(NSObject(NSObject) do^sNotR... 

_forwarding_ 

一 forward ing_prep_0_ 

HI 13 -(UlLabel setText:) 


□ 15 

□ 16 


[UITableView(U[TableViewlnter … 
6 - 【 UITableView(UUableViewlnter … 

□ 17 -(UlTableViewLUITableViewPriv... 
1"1 18 -(UlTableView layoutSubviews] 

19 -[CALayer layoutSublayers] 

H 20 CALayerLayoutlfNeeded 
H 21 C A: : Context :: com mit_tran sacti o... 
内 22 CA::Transaction::commitO 
口 23 - [UlApplication _reportAppLaun... 
n 24 -[UlApplication _runWithURL:pa... 
1"1 25 -(UlApplication handleEvent:wit... 
n 26 -[UlApplication send Event:) 

I"! 27 JJIApplicationHandleEvent 

□ 28 Purple Eve ntCal I back 

H 29 —CFRUNLOOPJS_CALUNG_OUT.“ 
0 30 _CFRunLoopDoSourcel 
PI 31 一 CFRunLoopRun 
B \? CFRunl nonRunSnprifir 


A 


indexPath 


static NSString ^Cellldentifier = 

UITableViewCell ^cell = [tableView dequeueReusableCellWithldentifier: Cellldentifier]; 
if (cell == nil) { 

cell = [[ [UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseldentifier: 
Cellldentifier] autorelease 】 ； 

} 




// Configure the cell, 
cell. textLabel.text = [self, 
return cell; 


drinks objectAtIndex: indexPath. row 】 ； 


Thread 1: Program recerv€d signal •SIGABRT*. 


H Q* i ♦ I DrinkMixer > 我 Thread 1 


- [RootViewControlle r tableViewicellForRowAtlndexPath:) 


A 


All Output i 


Clea r □ O □ 


self = (RootViewController *) Ox... 
一 cmd = (struct objc.selector *)... 
tableView = (UfTableView *) Ox... 

► t indexPath = (NSIndexPath *) Ox... 

► t cell = (UITableViewCell *) 0x4b … 

► I Cellldentifier = (NSCFString *)... 

^*y ih 9 ^Oh-tihuc how 
keep 心 ili 叫一 
^Hhk/VIixc\r has bcch 
s ^ppcd by 


GNU gdb 6.3.50-20050815 (Apple version gdb-1518) (Thu Jan 27 
08:34:47 UTC 2011) 

Copyright 2004 Free Software Foundation, Inc. 

GDB is free software, covered by the GNU General Public License, 
and you are 

welcome to change it and/or distribute copies of it under certain 
conditions. 

Type "show copying" to see the conditions. 

There is absolutely no warranty for GDB. Type "show warranty" for 
details. 

This GDB was configured as M x86_64-apple-darwin".sharedlibrary 
apply-load-rules all 
Attaching to process 91576. 

Pending breakpoint 1 - ,,n RootViewController.m" : 19" resolved 
Current language: auto; currently objective-c 

(gdb) next 
(gdb) next 

2011-02-26 15:22:16.294 DrinkMixer[91576:207] -[_NSCFDictionary 
isEqualToString:] : unrecognized selector sent to instance 0x4elfOdO 
2011-02-26 15:22:16.313 DrinkMixer[91576 ： 207] Terminating app 
due to uncaught exception 1 NSInvalidArgumentException ' 9 reason: 

[_NSCFDictionary isEqualToString:] : unrecognized selector sent to 
instance 0x4elf0d0_ 

料 * Call stack at first throw: 




a I 


0 CoreFoundation 
— exceptionPreprocess + 185 

1 libobj c.A.dylib 
objc_exception_throw -f 47 

2 CoreFoundation 
(NSObject) doesNotRecognizeSelector:] 


0x00da9be9 
0xOOefe5c2 

0x00dab6fb -(NSObject 


187 


f[Y\d s Imc 七 ha 七 
caused ^oblcw. See 
4 a 七、 50 * 1^5 oy\ yc-t? 
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plists and modal views 



O 


So the exception talks about NSCF 
Dictionary...maybe it has something to do 
with the new drinks directions we uploaded 
for the detail view? 


You’re on to something there. 

Let’s take a closer look. 


Sharpen your pencil 



Using what you’ve learned so far, figure out what’s going on! 


The exception talks about NSGF Dictionary. What dictionary is it talking about? Where is it coming from? 


Who’s sending messages to the dictionary? Why did we get an unrecognized selector? 
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square peg, round hole 


Sharpen your pencil 
< Solution 


Using what you’ve learned so far, figure out what’s going on! 


The exception talked about NSGF Dictionary. What dictionary is it talking about? Where is it coming from? 

The did-tior\a\rics arc -fv-om plis*t| W\\tY\ y/c load plist, y/e hoy/ have dh array o-f 

did*tioha\rics *ms*tcad ^ y \ array of stv-ih^s. 

Who’s sending messages to the dictionary? Why did we get an unrecognized selector? 

Messages arc bemg, scr\*t *bo did-tiohary y/c *tv-y bo srt *thc dell’s label l*t’s ad*bually -the 
label schdmj i*t a message (see -the siadk -frame, dode m U(Label), se^dm^ messages as 

■though -the dell label wcv-e a Bu*t r^ow wcVe assi^'m^ a di^*tiohav-y bo -the label 





RootViewController.m 


WcVe trying to stuff a dictionary into a string 

Putting a dictionary into the text field of the label, which wants a string, 
isn’t going to work. Our previous array was an array of strings, so that 
code worked fine. Now that we have an array of dictionaries, we need to 
figure out how to get the drink name value (a string) out of the dictionary, 
and then assign that to the text label. If you take another look at the 
DrinksDirections.plist, you’ll see that we have an array of dictionaries — 
one for each drink. As we saw earlier, dictionaries store their values using 
keys; they’re just a collection of key-value pairs. To get a value out, you 
simply send the dictionary the objectForKey:@ M key" message. 


Instead o-P 


ins^cda o-r dssighmg the av-v-ay 

-to the label, 
you II heed -to pull out the harrte 
value -P\rom the appvopv-iatc 
di^tiohav-y. 



somelabel.text 


♦ 


Dictionary 

name = Cupid's 
Cocktail 

ingredients = 

Cherry liqueur f 
peach ... 

directions = 

Shake ingredients 
and strain into. 


Jfoy ar^d so 
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plists and modal views 


Update your code to handle a 
plist of dictionaries 

Armed with the knowledge of how the dictionaries are 
put together, we can use this information to populate 
the detail view, too. If you give the detail view controller 
the dictionary of the selected drink, it can populate the 
view’s fields before the view is shown to the user. 


Sharpen your pencil 


Eadh di^-tiohav-y has 

• loh^iry {o -the dai^sou^c 
dc-tail view. 



Go ahead and make the changes below to your app. After this, it should 
know that you’re using an array of dictionaries, not strings — and the 
detail view should have a reference to the drink it should display. 



Change the way a table cell is configured. 

In RootViewGontroller.m, fix the cell’s textLabel.text property to use the 
name value from the appropriate dictionary. 

Dod abou 七七 he KSpidtio^avy 

AoC\A^tr\i^hoY\ \( you *to lo^ov/ move 
dbou 七 did*tior>av-*ics. 




Add a reference to a drink dictionary in the detail view. 

In DrinkDetailViewGontroller.h, add an NSDictionary* instance 
variable named drink_ and the corresponding property declaration. 



Add drink to the DrinkDetailViewController.m file. 

Synthesize and dealloc the new dictionary reference. 







A/cU 认 values *m 
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updating for dictionaries 

Sharpen your pencil 
< Solution 


Go through the code and make sure 
that you’ve got everything right... 


// Configure the cell. 

cell.textLabel.text 

objectForKey : @"name"]; 

- 

return cell; 


[[self.drinks objectAtlndex:indexPath•row] 
_ Use ^ 


\t 






■ 





RootViewController.m 


〆 


Qprivate 

UITextField *nameTextField_; 
UITextView *ingredientsTextView 
UITextView *directionsTextView_ i 

NSDictionary *drink 


pcdlarc 狄 7 决 

• m sta^e va^aWe a,d 
Y /狀 ^ usual 心 m 
atbrUcs. 


Qproperty (nonatomic, retain) 
Qproperty (nonatomic, retain) 
Qproperty (nonatomic, retain) 


工 BOutlet UITextField *nameTextFiel< 

工 BOutlet UITextView ^ingredients^exty^i- 
工 BOutlet UITextView *directi oh sText\ 


©property (nonatomic, retain) NSDictionary *drink; 


■ 



This shouldn't be ou 七 Irt s\y\tc v/c wor / 七 be 

settmj i*t *thv-ou^h Buildcv-. 


DrinkDetailViewController.h 


7\aa d\r*mk *to SY^CSI« I'mc. 


@synthesize drink=drink 

View=ingredientsTextView 


nameTextField=nameTextField—, ingredientsText 
directionsTextView=directionsTextView ; 





(void)dealloc { 

[nameTextField_ release]; 

[ingredientsTextView_ release]; 
[directionsTextView 

[drink 一 release]; 

[super dealloc]; 



sc ouv 


@end 





DrinkDetailViewController.m 


204 Chapter 5 





































plists and modal views 



TesT DriVq 


Now that we’ve told DrinkMixer how to deal with dictionaries, go ahead and build and run. Make 
sure that the breakpoints are off! 



rB 

■ Carrier 3 2:04 PM o| 


Drink Mixer 


Ingredients: 

Lorem ipsum dolor sit er el it 
lamet, consectetaur cillium 
adipisicing pecu, sed do 
eiusmod tempor incididunt ut 

Directions: 

Lorem ipsum dolor sit er elit 
lamet, consectetaur cillium 
adipisicing pecu, sed do 
eiusmod tempor incididunt ut 


It’s working again! Vow tlrat it’s not 
craskingf, it’s time to lilt in tke details. 
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filling in the drink details 


The Petail View needs data 



Now that you’ve figured out how to deal with 
dictionaries, it’s time to fill in the drink details. 
But getting the details out of the array of 
dictionaries to give to the datasource requires 
another step. 


丁 his is the ih 

Dv-ihkspi\rcd-tiohSj>|is-t. 


Key 
卜 Item 0 
rltem 1 

directions 
ingredients 
name 
W Item 2 

directions 
ingredients 
name 
▼ Item 3 

directions 
ingredients 
name 
_ Item 4 
_ Item 5 
’ Item 6 
^ Item 7 
— Item 8 
， Item 9 
卜 Item 10 
_ Item i l 
p- Item 12 
_ Item 13 
_ Item 14 


Diction... 

Diction... 

String 

String 

String 

Diction... 

String 

String 

String 

Diction... 

String 

String 

String 

Diction... 

Diction... 

Diction... 

Diction... 

Diction... 

Diction... 

Diction... 

Diction... 

Diction..- 

Diction... 

Diction. 


^/alue 

items) 

、 — items) 

pAir the ingredients into aj 

scAt^i wilisky, coconut rur 1 
Afiwsliock 

(3 items) 

Pour all ingredients into a 
Vodka, Sour Apple Schnapp 
Apple Martini 
(3 items) 

Pour the liqi^ur into a g 叫 

cinnamon schnapps s hard 

Baked Apple 
C3 items) 

(3 items) 

<3 items) 

[3 items 〕 

(3 items) 

[3 items) 

(3 items) 

.[3 items} 

(3 items) 

£3 items) 

(3 items) 


T\\t da-tasouvtc 
y\ccds W\t 
d\chov\^ 

m-fovrw3 , tioy\ 

•fov 七 V>c 
sc\tdtA dv-'mk. 




0*103* MC* 








； cwcwkcv- -tWis? TV^IS IS {Mt 
st\rutWc a ??* 





How are we going to get the information from 
DrinksDirections.plist into the Detail View? 
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plists and modal views 


The other keys arc key 

Right now we’re just pulling the name of each drink into the app 
using the name key. In order to populate the ingredients and 
directions, we need to use the other keys. You could just type those 
right into our code, but you’re a better developer than that, so let’s 
pull them up into constants. The only thing left is getting the 
proper dictionary to the detail view controller so it can pull the 
information it needs. Go ahead and start setting everything up! 



The View Controller needs direct access to the datasource, 
and the easiest way to get to that data is going to mean 
some quick code refactoring. 



Organize your dictionary constants to avoid bugs. 

Since we’re going to need the name, ingredients, and directions keys in the 
View Controller, we should clean up the code to start using real constants. 


Create a new file called DrinkConstants.h (right-click on the DrinkMixer 
folder, then choose New File, and then choose Other and an empty file). 

Add constants (#defme , s) for NAME—KEY, INGREDIENTS—KEY and 
DIRECTIONS—KEY. Import DrinkConstants.h into DrinkD e tail Vie wG ontroller. m 
and RootViewGontroller.m. Finally, update where we use the @"name" key to the 
new constant, NAME_KEY 



Set the detail View Controller’s drink property. 

In the root View Controller, after you instantiate the detail View Controller when 
a cell is tapped, you need to set the drink property on the new controller to the 
selected drink. 



Add code to the detail View Controller to populate values on the 
UI controls. 

Before the Detail View appears, the View Controller should use the drink 
dictionary to set the contents of the name, ingredients, and directions components. 
Don’t forget to use the constants you just set up! 
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cleaning up with constants 


_ !RciSe 

lutlOH 

o 


Exei 

m 


Here’s all the added code to make the Detail View work. 


Create DrinkConstants. h. 




DrinkMixer - DrinkContstants.h 



DrinkDetailViewGontroller.m and RootViewGontroller.m both need 

WcVc 

keys *to doy>s*tair>*ts iicv 


#import "DrinkGonstants.h M . 

Then add the constant to display the name: 



// Configure the cell. 

cell.textLabel.text 
objectForKey:NAME— KEY] 

return cell; 


k ■ •"余 \ 

RootVie 


RootViewController.m 
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plists and modal views 


❺ Set the detail view controllers drink property 


#pragma mark - 

#pragma mark Table view delegate 

- (void)tableView:(UITableView *)tableView didSelectRowAtlndexPath:(NSIndex 
Path *)indexPath { 

DrinkDetailViewController ^detailViewController = 

[[DrinkDetailViewController alloc] initWithNibName : Q^DrinkDetailViewContro 
ller 〃 bundle : nil]; 


detailViewController.drink = [self.drinks objectAtlndex : indexPath. 


row]; 


[self.navigationController pushViewController : detailViewController' 
animated:YES]; 

巧 this whole lihe -to 


[detailViewController release]; 




a 




、 鮝 一 • 1.1 一 〆 • •一 • 产 

RootViewController.m 

❺ Add a method to the detail View Controller to populate the fields. 


y>ccd *to make su^rc >/c delegate 
七 Wis uf 七 ^ UlVicv/Co^ollcr 

su?c ^lass bcW v/c do else. 


TW»s >uV\olc method 

- (void) viewWillAppear:(BOOL)animated { 

[super viewWillAppear : animated]; 

// Set up our UI with the provided drink 

self.nameTextField.text = [self.drink objectForKey:NAME_KEY]; 

self.ingredientsTextView.text = [self.drink 
objectForKey: INGREDIENTS 一 KEY] - **^ /W a 代 

self. directionsTextView. text = [ self. drink Y ou j uS 七 ⑽ 3 七 € 土 

objectForKey:DIRECTIONS 一 KEY] ; 

DrinkDetailViewController.m 
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so thafs whaVs in a cupid’s cocktail! 




Tqst DriVQ 


Compile and build and run again... 



Dumb Questi9ns 


It works! 


We re-create the Detail View every 
time someone taps on a drink. Couldn’t I 
just reuse that view? 

For DrinkMixer, it really won’t matter 
too much; since the view is pretty lightweight, 
we won’t suffer too much overhead re¬ 
creating it when a drink is tapped. However, 
for best performance, you can refactor it to 
reuse the same detail View Controller and 
just change the drink it should be showing 
when a row is tapped. 

Why did we have to pull out the 
dictionary key names into a separate file? 


Having magic string values in your 
code is generally a bad idea—no matter 
what programming language or platform 
you’re using. By pulling them up into 
constants using #define, they are checked 
by the compiler. So a typo like @”nme” 
instead of @’’name” would end up as a 
bug at runtime, while mistyping NME_KEY 
instead of NAME_KEY would prevent things 
from even compiling. 


I looked at the NSDictionary 
documentation and there’s a 


valueForKey: and an objectForKey:. 
What’s the difference? 


Great question. valueForKey: is 
used for what’s called key value coding, 
which is a specific pattern typically used 
in Cocoa Binding. The subtle catch is that 
NSDictionary usually just turns a call to 
valueForKey: into a call to objectForKey, and 
it looks like either one will work. However, 
valueForKey actually checks the key you 
pass it and has different behavior depending 
on your key. That’s almost never what you 
want (unless you’re doing Cocoa binding 
stuff, of course). The correct method to use 
is objectForKey:. 
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plists and modal views 


Head First 

Lounge 



Is that app up on the App Store? Then I can 
just download it on my phone and start making 
even more tips! 


Sam, v-cady -fov- your 
app "fco make V^is 
ou\r) y/3llc*t fattd. 


Looks like tltere’s a market tkere! 
A ejuick sulnnission to Apple anct … 
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a modern-day dear john letter 


:::::: 

卜一 N f es A 二二 

㈤ 二：:工 ㉝ 工二） v 

views are not using — ⑽油 lnte rface Guide 

1 _工二°工 一一。 ' 

1 Te^bmit your app &r ” 


Tir^C {/> 

'^vcs-tija-tc 
七 he W/^... 


UPS 




We’ll go through the approval 
process later. 


Later in the book, we’ll take you through 
the process of preparing an app for 
approval. For now，just worry about how to fix DrinkMixer! 
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Wc have a usability problem 

We know that the user needs to touch the name of the drink 
to see the details about each individual drink, but how is 
the user supposed to know that? The HIG has a number of 
recommendations for how to deal with drill-down, hierarchical 
data. We’re already on the right track using table views, but 
the HIG has a number of additional recommendations for 
helping the user understand how to navigate the app. 


Tabic u\\s v^avc d mJotr built - m usaW’t/ 

*,-terns -tKa-b users u^dersta^d Kow *to use 

研一 ev ⑼ J it’s 七 he time vc 

r\AV\ it* 



tteve is i\\t rooi View 从 a 七 
usevs see, tabic v\cy/. 




Ch«r p h-iw. 


• ^{iNh>w 
1 eilc* ^ ㈣ 4 




七 usev 

-taps, 七 
Co^'brollcv' 
oW toy\*tv-ol *to 

detailed V»cy/. 


Sharpen your pencil 


It’s time to dive into the HIG and figure out what went wrong. 


Take a look at disclosure indicator elements — when should we be using these? 


The HIG mentions detail disclosure buttons and disclosure indicators — which should we use? Why? 
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disclose your intentions 


%Sharpen your pencil 

Solution 


It’s time to dive into the HIG and figure out what went wrong. 


Take a look at disclosure indicator elements — when should we be using these? 

|h w Tabjc \/icy/ W sedtioh, you C^y\ ^ui^kly ou*t vyhy youVc m violation oyer -those 

disclosure *mdida*to\rs ： 

“The disclosure indicator element...is necessary if you’re using 
the table to present hierarchical information.” 

The HIG mentions detail disclosure buttons and disclosure indicators — which should we use? Why? 

The disclosure *mdi^a*bor demotes 七 is ar\ additional level o-f *m-fo\rma*tior\ available dbou*b dh i*tcrw 
yn\\tY\ you didk i 七 Oikc dhr’mk details )； i*t selects *tha*t row ar\d shows *thc additional dd*td- The button ddh 
do somc-thmj besides seled 七 roy/—i*t 乙 an kidk o-f-f dd*bioh as well. Tha*t’s nr\orc 七 han y/dl Y\tt& here, 

so y/cll \us-t s*tidk wi*th *thc disclosure *mdid3*to^r - 


Ta^Je Cells Up Cl^se 


So, what exactly is the detail disclosure button, and where does it go? Let’s look a little 
deeper in the HIG. 


cx^ 


TW,s ^ 

td {p 




tLtM ^ 3 



This is ihc dc-tailTcxiLabcl. 
Dcpc^di^j oy\ whai ^cll siylc yoi 
use ， i*t show up m di-pTCV*c^"t 
plades, -Po^ts, a^d dolovs. 


^ ::作-一 

多 ttU a^d 


DrinkMixer uses default cells, but you can easily customize your cells for a different app, 
besides just adding detail disclosure buttons. There are a few other types of cells in the API: 
subtitle cell style, a value 1 style (where the first value of the cell is emphasized), or a value 2 
cell (where the second value of the style is emphasized). Even though the table only supports 
one column, you can make it look like more by adding a thumbnail, for example. You can also 
adjust the font sizes to open up some room for each table cell if you need to. 

Most really polished apps use some kind of table cell customizing, so keep that in mind while 
you’re looking through the API. For now, we just need to add the disclosure button to our cells 
to indicate that there’s more information available if a user taps on them. 
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plists and modal views 


Use a disclosure button to show that 
there arc more details available 



we’re just 
is 


ableViewGells have a lot of built-in functionality — wc ic j 
: ratching the surface. Adding a detail disclosure indicator 
mply a matter of telling the cell what type 
? accessory icon it should 科 n n | 

Take a look at the 


: TableViewGell 
cumentation for some 
the other options. 


^ 2 一 

r , UIKit RufurBrate UpiUl* ] 

U uruw 邮 v/tw 咖 …㈣ 阶 
urfjW 曲 wW 砂 r *= 

Vi Can- [MTiTiunriai for 10$ 

“ uitjW«v«wI>j* B * re,enl * 
I |Tf iphnrw 05 ? 0 * P1 rjl ^ ，t 

^ u_ 洲 *0 讲鉍 ⑽ nK 

Yooli C-uid'C® 

I U Uf Results 

备 *mpl« Csrtl« 

卜 ⑽ eC«^ 

I ^ ^ oa*sC** 

喿 Adv^i«iJTjW«Vie«Cdl» 

-- Ai jmfiDei3TaW*viw**il* 

4 T*-5K Jt 81 

I ^ Ujg^fctfUKatlW* 

I 产， iPhuneCoi*DsiuRfltipefc 
I p .*rcc«$enf 

1 Arivanr^c3UMf-iwn#rticin'i 


Organl 加 - D ⑽ m 抓 Mlon 

s __ — 
uru& 比 [ 挪 

~~ ▲ 4 ^ Af ctll a£c 

3 rnoAthe^ 一 痛 〆 一 

Oil Accessory Type 

v :一 

This i5 lhe dEfftutl value ' 

^Ubi e imfton S Ofi^a«d la«r. - - 

rZudl doesn't track touches. \ 

如曲 ble in ^OhStaht you h«d. 

工二二二 ― —■ 

bailable In l_e «2._dl^. 

UVtl 抓 d in tKTAhl 抑 i 邮 wUh- . a= - he d£ 5 e q a tt of tht tabte 

n 一一一 

Available it _ 砷仿⑺邮 11 抑 ! 1 


There’s just one quick line of code to set the cell’s accessory type when 
we configure the cell: 



// Configure the cell. 

cell.textLabel.text : 
valueForKey:NAME—KEY]; 

cell.accessoryType 

return cell; 


Jus-fc set the a^dcssov-y type io the 
detail disdlosu\rc ihdi 公 tov ». 、 


[[self.drinks obj ectAtlndex:indexPath.row] 




UITableViewCellAccessoryDetailDisclosurelndicator 




RootViewController.m 


Tesr DriVq 


Go ahead and build and run...make sure it’s working! 


you are here ► 


215 









ready to resubmit to the App Store 




TesT DriVq 


One little line of code fixed all of your App Store approval issues. 


Carrier 1:43 PM 


Drink Mixer 

Deer Hunter 

> 

Firecracker 

> 

Flaming Nerd 

> 

Gingerbread Man ^5 

Key West Lemonade 

> 

Lemon Drop 

> 

Letter Bomb 

> 

Long Island Ice Tea 

> 

Lost in Space 

> 

1 ■ • ■ 麄蟲 1 


T\\trt avc 铷 0 sc 

dlS 6\os^e 
^ uscv 

仇 at 仫如！ 
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plists and modal views 


This app is great! I'm 
going to use it every night. 



Alter resutmittingf to tke App Store, 
DrinkMixer is up on iTunes! 


Sales report - DrinkMixer - Week 1 
Overall sales - 400 downloads 


jus-t 

^ 0}r oy\t week/ 


Price-$1.99 

Overall revenue 


S796 ；： 


D eJttr A??' c 
oUW. 


Tke 


• • 


reviews are coming m … 
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meanwhile, back in the App Store 


Sales were going strong 


But then bad reviews started coming in. What’s 
going on? 



_Mix er 


Smri * ^ ^rren 


f l>had f 1 , 9f lfl4ja 




Oriniw ll：ft 


Cocfctji,, Mitn 


SI •的 


0 u yAp^ 




«15 


d 叩 ㈣ rmar^ 


神 oneSer 咖 
^Arrttr o» 
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Sas.fi. 4 WB 






l,q —<hol cho =: h 


C^coolung 


74 Rjibngt Rate this appHc«tk)n ： ★ ★ ★ ★ ★ 
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Customer Reviews 

Wr#*«R«vttw > 


5 «n 恥 


rri ； 


w /\Zly bar V)ds some 6us*tom 
dvmks dr^d I Aor!i >wa^*t 
•to keep a sepav-ate sVicc*b 
dv-mks avoiAir\d- 


Tiicy say -tWmjs like 
w py*mk/\/l*»%cv- su6ks -1 ， 
add 扣 ytWmf 


l\Y\oi\\tr \rcv'icy /： 
w | y\eed mov-c 

dv-'mks ^ 


w l do^^i like a^y <4- 

"the dv-i^ks oy\ the 

list” 


Yrw ^o'm^ *to swrtdh *to iPv'mk— 

•i 七 ’s move ocpc^sWc, bu 七 ••七 Icis 
me add r>C>w dv*'mks ar>d tus*tom'iz^ 
my list” 


u ， 〆. 
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plists and modal views 


rpen your pencil 


Think about how you originally designed DrinkMixer, what’s not 
working based on the feedback, and figure out what you’ll do next. 



What would address the users’ concerns? 



Given the structure of DrinkMixer, how would you refactor the code to fix the problem? 



Is there an easy way to fix the code? A hard way? 
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give the people what they want 


^Sharpen your pencil 

Solution 


O 


Think about how you originally designed DrinkMixer, what’s 
not working based on the feedback, and figure out what 
you’ll do next. 


What would address the users’ concerns? 


The easiest way bo -fi% -the problem is to update tKc app so users cby} add drmks 

to *thc list 


Given the structure of DrinkMixer, how would you refactor the code to fix the problem? 

Wt 6ould add d view lets users cr\*tcv *thciv dvmk |*t dould look like 

jjr\t detail view, bu*t allow them to -type *m -the *thcy waht I/Vcll Kavc save 

*tha*t hew *m-fo\rma*tioh ar\d update -the -table *bo show -the r\cw dvmk. 


❺ Is there an easy way to fix the code? A hard way? 

There arc lo*b o-f hard v/ays ar\d fvobably a -fey/ good u casy w ways. general, -the 
easiest y/ay -for us *bo add *this -fuhd*tiohali*ty is *bo reuse as mudh o-f wha*t v/c^vc already 
dor\e as possible. We c^y\ dc-f*mi*tdy -take adva^-ta^c o-f our Navigation Corrbroller, ar\d 
let’s see i-f we dar /七 do somc*thrn5 use-ful wi*th our Dc*tailD\rmk\/icw *boo … 





How would you go about implementing a view 
where users can add drinks to DrinkMixer? 
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plists and modal views 


APP MYOIJI CONSIRIJCIIOIX 1 


Here is the table view for DrinkMixer with two possible 
designs. Based on aesthetics, usability, and standard iOS 
App behavior, which one is better for showing the users 
where they should add a drink? 


Some kihd o( but-toh ih -the 
: ioh Coh-tvollcv- -fco ki 匕 k 

a v\ 




Add 9 hew 'toolbdv y/rth some 
buttohs below the Nav Cohtrolld 


Flaming Nerd 


GEngerbread Man > 


Key West Lemonade 


Lemon Drop 


Letter Bomb 


Long Island \ce Tea > 


\ 4 u’d have 

V"oorh -fo\r dh 

add but-fcoh 3 hd 
othev-s, whch you 
>^ccd tilers. 


Lost in Space 


Option #1 


Option #2 


Which interface is better? 


Why? (Be specific.) 


Why not the other? 
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built-in buttons 


APP MYOIJI CONSIRIJCIION SOLUTION 


Here are two designs. Based on aesthetics, usability, and 
standard iOS App behavior, which one is better for showing 
the users where they should add a drink? 


The A/avigatioh Cohtvollcv 

匕 。咖 《 With buili-i h butt> h 

suppov-fc. 



This type \y\i^fau is ^ood y/keh 

y ou hve several hew views -to add, 

hot jus-t OhC. 



I Carrier 亨 1:45 PM 





■ 

Cat's Meow 


Cupid's Cocktail 


Day at the Beach 

> 

Deer Hunter 

> 

Firecracker 

> 

Flaming Nerd 

> 

Gingerbread Man 

> 

Key West Lemonade 

> 



TV^c *toolbav- W\W 
to^cc uf pa\rt o-f 
-table v*icy/> *too. 


Option #1 


Option #2 


Which interface is better? Option #1. . 

Why? (Be specific.) jpy.puttmg *t]hc idoh m -the Nay Cohty-ollcv.). you doys j ： *(^kc spade away -fyorift 

•the *bdble view. There’s also buil 七 - m support -for 七 butto 妁 m *thc Nav Corrbroller alreddy ； 

Why not the other? !^ 2 L. .ih?. Vli. 3 rid y'.^uiv-cs r^ort cpdt. j-P 

-thcv-C was lo*ts o-f hew *fu^*tiphality dommj, i*t would be W • 七 h 
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plists and modal views 


Use Navigation Controller 
buttons to add drinks 

So far we’ve used the Navigation Controller to move between 
views. But if you’ve spent much time with other iOS apps, you 
know it’s capable of much more. Since a UITableView is almost 
always embedded in a Navigation Controller, table editing is 
usually done through buttons on the controller itself. Let’s start out 
by adding a + button to the Navigation Controller that will let the 
users add a drink when they tap it. 


i^harpen your pencil 

Using Xc 



Ws cirs will be able 

ku-t*to h ^ ^ ^ 
dHhk. 


Using Xcode, add the button to the Nav Controller and 
the associated IBActions and IBOutlets. 





Open RootViewController.xib in the GUI editor. 

Scroll through the library and drag a Bar Button Item to the Main 
Window (this will add it to the list after the Table View). It won’t show 
up on the Navigation Controller in the editor — we’ll need to add code 
so it shows up at runtime. 

Add the instance variable and property declaration for 
add Button and IB Act ion for addButtonPressed. 

Just like any other button, we’ll have an IBAction for when it gets clicked 
and a reference to the button itself — all in RootViewG ontroller.h. 


\i ^ 

^ bemuse 

•、 s SIMUUATtP 

^ 0 *t v-cal- 


cr 



Add the synthesize, dealloc, and addButtonPressed method 
for add Button. 

Synthesize the property, release the reference, and implement the 
addButtonPressed to log a message when the button is clicked — all in 
RootViewGontroller.m 



Finish up in the links. 

Open up RootViewController.xib again and link the new Bar Button 
Item to the actions and outlets within the Main Window. 


Finally, pull up the inspector in the Utilities pane for the Bar Button 
Item and change the Identifier to Add. 
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add the button 


%iharpen your pencil 
、‘ Solution 


Using Xcode, add the button to the Nav Controller and 
the associated IBActions and IBOutlets. 


o 


❻ 


Open RootViewController.xib in 
the GUI editor. 

Scroll through the library and drag a 
Bar Button Item to the Main Window 
(it will get added to the list). 

Add the instance variable 
and property declaration for 
add Button and IBAction for 
addButtonPressed. 



Qinterface RootViewController : UITableViewController { 

NSMutableArray *drinks_; 

UIBarButtonItem *addButton_; 

} 

Qproperty (nonatomic, retain) NSMutableArray *drinks; 

©property (nonatomic, retain) IBOutlet UIBarButtonItem *addButton 
- (IBAction) addButtonPressed : (id) sender; 

@end 



(^) Add the synthesize, dealloc, and addButtonPressed RootViewController.h 

method for add Button. 


@synthesize drinks=drinks , addButton=addButton ; 



#pragma mark- 
#pragma mark Actions 

- (IBAction) addButtonPressed : (id)sender { 
NSLog(@"Add button pressed!"); 


RootViewContn ll er.m 



II by 

bu^toh plrcss so wc ^ iesi it 
bcTO\rc irwpIcrhCh'tmg dhy'tliih^ 
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plists and modal views 




pu 七仏 is inside o( V\^V\dLoad, i-t's a tv/cak o( -the Code -that's stubbed out 
self.navigation!tem.rightBarButtonltem = self.addButton 



o Finish up in the view. 

Open up RootViewGontroller.xib again, and link the new Bar Button 
within the Main Window, right-clicking and using the menus that pop 

Finally, pull up the inspector for the Bar Button Item and change the Identifier to Add. 


ItenA 

up/ 


RootViewController.m 

to the actions and outlets 


_ DrinkMixer - RootViewController.xib 


Running DrinkMixer on iPhone Simulator 
No Issues 


inkMixer > ^]Dr... > Ro... > A RootViewController.xib (English) > Bar Button Item - 




m\W iM 


0 Placeholders 


(:: File's Owner 
ij) First Responder 


^0 Objects 


Table View 



o Bar Button rtem - Add 

▼ Sent Actions 

addButtonPressed: n File's Owner 

▼ Referencing Outlets 

addButton m File's Owner 

New Referencing Outlet 

▼ Referencing Outlet Collections 
New Referencing Oudet Collection 


Brea 

jrlingame 
anoga Park 
arlsbad 


D □ e *•» 

妒 o 

▼ Bar Button Item 

Style Bordered 

3 

Identifier Add 

LI 

▼ Bar Item 

Title 

Image 


Tag 


0 Enabled 
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button success 




Tesr DriVq 


Go ahead; build and run the app... 


\ Carrier ^ 1:47 PM , B>] 

ic'aJi 

After Dinner Mint 


Aftershock 

> 

Apple Martini 

> 

Baked Apple 

> 

Bee Stinger 

> 

Beetle Juice 

> 

Black Eyed Susan 

> 

Blue Dog 

> 

Bookmaker's Luck 

> 


The butto 灼 >wovks| 
Moyj you ^c*t 3^ 

message 



Type "show copying" to see 
conditions. 

absollJte1 ^ no warranty for GDB. 
lP e _^ ow warranty" f or details. r 

This GDB was configured as M xB6 64 f 

apple-cfa^in".Attaching to process 

0 ?； 51 ； 31 554 DrinkMixer 
[13573^297] Add button pressed! 


Tke tutton skows up in tke 
view, tut now wkat? 
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plists and modal views 


The button should create a new view 


Our new button works: the action gets called, but really doesn’t do 
anything useful yet. We need to give our user a place to enter the 
new drink information, and we can do that with a new view. Just 
like with the detailed view, we can let the Navigation Controller 
handle the transition. 





Root 

ViewG ontroller 






口土 xt : 二“ 






O 

AddDrink 
ViewG ontroller 




DetailDrink 
ViewG ontroller 



gulled ^ 

m-fovwat»o^ out vicv/ 

pcta.IP^^Cv/Co^ollcr rub. 


What do we need for the user to be able to enter a new 
drink? Exactly what fields do you need and how will you 
lay them out? How will the View Controller work? 
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reuse your view 


Wc need a vicw...but wot necessarily 
a wgw view 


Our “new” drink view is really just an editable version of our detailed 
view. So instead of creating a whole new nib, let’s take advantage 
of the fact that the UI (the nib) is separate from our behavior (the 
UIYiew subclass in the .m file) and reuse the detail view. 


Up until now, we’ve had a one-to-one pairing between our nibs 
and our View Controllers. That’s definitely the norm, but our View 
Controllers are really just normal Objective-G classes. That means 
we can use object-oriented extension mechanisms like inheritance 
to add the behavior we want. 


^ Wd io support 

饮 CKrt behavior 

七 hh "the dc-bil 1/icw 
Co^hroWtY, though. 

heed a hCW view 
^Oh*t\ro|lcv-. 


Tk add dv'mk wds 
^ same 

Uds as ^ deta.l = 一，七 

• 、 us 七 ^ccds bo V>c e 中咖 . 



AddDrink 
Vie wC ontroller 



l^hch you dlidk oh 
"these text -fields, 
the keyboard will 
pop up 3hd let 
you Chtcv- hCW 
ih-pov^rwatioh. 


DrinkDetailViewController.xib 



O 


Really, a new view controller 
but not a new nib? I thought 
they always go together. 


Not necessarily. 

Remember that a xib is just the XML representation of a view. Using 
nibs is a lot easier than trying to lay out your view using code. And since 
the nib is just graphical information, you need to put the actual code 
somewhere else. That’s where the view controller comes in... 


228 Chapter 5 



























plists and modal views 


The View Controller defines the behavior 
for the view 


From the user’s perspective, we’ll have three views: the table view，the 
detailed view，and the new drink view. But, since we’re reusing the .xib 
to create the “new” view, all we need is a new view controller class that 
supports adding a drink. That means there isn’t any Interface Builder 
work to do at all! 






kp 

sa〆 ， 






vt ^ ^ a ‘ 



◄ - 





cd tWv 


S V\ONJ — 


—— 




[ Name- 

1 

| 呼 ediovts: 



PurCdtiOhS ： 




DrinkDetailViewController.xib 


DrinkDetailViewController.m 


TV,e V.ev/Co^olle , 如 W s 匕 

•I yy^OV* W O • 


yA AtUts a»|d 

V»cv/s wll \ooV. the 

sa^c, v/c vcusc 


AddDrinkViewController.m 


TV^c 

s'mtc 


Separating tke UI from tekavior 
kelps you reuse your view* 





Reusing both the .xib file and the detail view 
controller is also an option. But where could we run 
into problems with that approach? 
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keeping track ol outlets and actions 


A nib file contains the U1 components and 
connections... 


One way we could reuse the nib is to create a new ViewGontroller and pass it 
the DrinkDetailViewGontroller.xib file when we initialize it. There are a few 
challenges with that, though. Remember, we don’t just use Interface Builder to 
lay out the interface; we use it to wire up the components to the class that will 
load the nib. 


r i. V oWcv V^as *tV>c W 产 

亡 


m tV>c 






^SailD\r*mk\/ic>wCoirrt^ollc\r 


fl 





** - 

*• - &**ot-a 
I ： hiw 
C 


一 (void) vicv/l/VillAppcav -： (BOOL) dhimaiedlj 




㈣ TOtiionte: 

^ 7191 - wmtateur c«_ 
yf kft^w 

irngru ^ ^ 

ITin4na 湖扣 J"r» naiK nn^anvi 

launri Ocliy b- 1 er eiii 
hrwi, CDT 4 «<t«iiur imurrq 

maw tBtw a i 

sto rw 4 'lifua u imlrn^cl 




物 , _ w _ 

U«r»n，«i 




...and information about the nib's File's Owner 

The nib doesn’t actually contain the Vie wG ontroller class it’s setup to be wired 
to. Instead, it does this through the nib’s File’s Owner. When you pass the nib to 
the view controller, it will deserialize the nib and begin making connections to 
the outlet names stored in the nib file. This means that if we want to pass that 
nib into another, new view controller, we need to make sure we have the same 
outlets with the same names, the same actions, etc. 



Watch it! 


Because of the way DrinkMixer is built, we can just subclass our 
detailed view to get what we need. That works great for this app, 
but be careful doing this in more complex apps, because your code 
can get difficult to maintain. Often, it’s better to just bite the bullet and build a 
new view...and sometimes you’ll realize they shouldn’t even look the same. 


Reusing our nib gets us what we need for this app，but 
it’s not for every app out there. 
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plists and modal views 


You can subclass and extend view controllers 
like awy other class 

Instead of reusing just the nib and having to recreate all the outlets and actions, 
we can just subclass the DetailedViewGontroller and add the behavior we 
need. Our AddDrinkViewGontroller is the same as a DetailedViewGontroller; 
it just has the ability to create and save an entirely new drink. Everything else — 
showing the name, showing the description, etc. — are all exactly the same as the 
DetailedViewGontroller. 


° Ve ^ ide a of methods. 



I IBOwtlft IXlUField 决 nameUField. 
ovaV* SVA^aSS-K I - 

七 w - (void) vicv/WillAffcav -： (BOOL) animated; 

0 说 

f \cW s ... 


AaaPv-mkPcta«l\/«^Co^oll^, 

hUrb su ? er6lass Ue 

py. m kPcta'«>\/''C^Co^oll^, 


First, we need to create tke new 
View Controller. 


you are here ► 231 











































when to reuse 


thereiore no o 

Dumb Questi9ns 


I still don’t get it about the new 
view controller without a new nib. 

There's nothing in that nib that you 
couldn’t create in normal Objective-C by 
hand. As you’ve likely discovered with 
Interface Builder, nibs are generally a lot 
easier to work with than trying to lay out 
your view using code, so when you create 
a new view, you typically create a nib to go 
with it. But really, you could build an entire 
application without a single nib. 

In our case, we’re going to do something 
somewhere in the middle: we’re going 
to create a new view but reuse the Ul 
information from another view. 

So why the “Watch it” warning 
about reusing the nib? Is this a good idea 
or not? 


Unfortunately, the answer is: it 
depends. For DrinkMixer, we can reuse 
our DetailDrinkView and its nib since we 
want the layouts to look the same and the 
DetailDrinkView doesn’t really do anything 
specific. However, in a more complex 
application, you might run into problems 
where you’re constantly fighting between the 
two view controllers or you have to expose 
so much information to the subclass that 
your code becomes unmaintainable. This 
isn’t a problem unique to iOS development; 
you always have to be careful when you start 
subclassing things. 

For our app, subclassing works fine, and 
you’ll see it in some of Apple’s example 
applications, too (which is part of the reason 
we included it here). But it’s equally likely 
that in some other application you’ll want 
views to be similar, but not quite exactly the 
same. In those cases, create a new view 
controller and nib. 


Do you usually have all your 
table cell initialization code in 
cellForRowAtlndexPath? 

It depends on how complex your table 
view and cells are. If your cell configuration 
is simple, sure. As you get more complicated 
table views (in particular, grouped table 
views with different kinds of cells), it gets 
unwieldy. Instead, consider creating helper 
methods that can configure a particular kind 
of cell. 

Another really important thing to keep 
straight is resetting a cell back to defaults. 
Your cellForRowAtlndexPath should always 
reset a cell back to default values before 
using it—you just don’t know where it’s been. 
Obviously, you can factor that code out into 
a helper method too, but don’t forget to do it! 
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plists and modal views 


Use Xcodc to create a View Controller without a nib 

What we’ll do is create a new ViewGontroller in Xcode that 
doesn’t have its own nib, and then tweak it to inherit from the 
DrinkDetailViewGontroller. This new view will get all of the fields, 
behavior (which we’ll change), and the nib we need. 


Sharpen your pencil 



Get into Xcode and create the AddDrinkViewController files. 



Create a new UIViewGontroller subclass named 
AddDrinkViewController without a nib using the New File 
dialog box. 


options m 

於 … dew 七 

y/ar\*t a y/'i*bVi *tV^c v*»cv/. 


Open up the new AddDrinkViewG ontroller.h file and change it to inherit 
from DrinkDetailViewGontroller instead of the UI Vie wG ontroller. Don’t 
forget to import the DrinkDetailViewGontroller.h file. 




^\\ add tV>c ^ 
v,ccd ^ a 


utc- 
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inherit the drink detaii view controller 


%iharpen your pencil 
< Solution 


Get into Xcode and create the 
AddDrinkViewController files. 


In the New File dialog box, you need to create new 
UIViewGontroller subclass files. Be sure to uncheck the 

With XIB for user interface box, since we don’t 
need that .xib file. 


,h 饮匕仪 the DHhkDctaiH/icwCo^oll^ 
WC heed -to impov-t the headev so -the 
khows what wcVc talkihg about 


#import <UIKit/UIKit•h> 

#import ''DrinkDetailViewController. h y 


@interface AddDrinkViewController : DrinkDetailViewController{ 

By dc-Pa ul 七 ouv- 

} Coivbrolleir mhev-i-ted -Pv-orw 

@ end UH/icwCo^i\rollc\r. Change -that -to 

IV … kDeHiev/CoKrtvollev- hcv-c- 



The AddDrinkViewController.m file can 
stay exactly as it is generated by Xcode. 


AddDrinkViewController.h 


Wait, why aren’t we just passing 
the nib into the AddDrinkViewController? 
Why all this subclassing stuff? 

We could do that, but the problem 
is we’re not just dealing with GUI 
layout. We have text fields and labels 
in there that need to get populated. Our 
DetailedDrinkViewController already has 
outlets for all the fields we need, plus it 
has the functionality to populate them with 
a drink before it’s shown. We’d have to 
reimplement that in our new view controller if 
we didn't subclass. 



Is this some kind of contrived 
Head First example, or should I really be 
paying attention? 

You should be paying attention. This 
pattern shows up pretty often and a lot of 
Apple’s example applications use it. It’s 
very common, particularly in table-driven 
applications, to have one view that just 
displays the data and another to edit it when 
the user puts the table in editing mode (we’ll 
talk about that more later). Sometimes you 
should use totally different views; sometimes 
you can reuse one you have. 


You mentioned that fields are 
protected by default. What if I wanted 
private fields in my class? 

It’s easy—just put @private (or 
@public for public fields) in your interface 
definition before you declare the fields. If 
you don’t put an access specifier there, 
Objective-C defaults to protected for fields. 
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plists and modal views 



Jim: Now we have an AddDrinkViewGontroller class, so all we 
have to do is push it on the stack like we did with the detail view ， 
right? 

Joe: That makes sense — we used the Navigation Controller to 
drill down into the data just by pushing a detailed view on the 
stack... 

Frank: Adding a new drink to our list is a little different, 
though. 

Jim: Why? 

Frank: Well, adding a new drink is really a sub-task. 

Joe: Huh? 

Frank: The users are stepping out of the usual browsing drinks 
workflow to create a new drink. 

Joe: Oh, that’s true. Now they’re typing, not reading and 
mixing a drink. 

Frank: Right, so for times like this, it’s important to 
communicate to the users that they have to complete the task. 
Either by finishing the steps or — 


Joe: — or by cancelling. 


Frank: So, what kind of view is that? 





Which of these views better communicates what the user 
needs to do? Is one more ambiguous than the other? 
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modal views are animated 


Modal views focus the user oh the task at hand... 

When users navigate through your app, they are used to seeing views pushed and popped 
as they move through the data. However, some tasks are different than the normal drill¬ 
down navigation and we really need to call the user’s attention to what’s going on. iOS 
does this through modal views. These are normal views from your (the developer’s) 
perspective, but feel different to the user in a few ways: 


：47 PM 




After Dinner Mint 

Aftershock 

Apple Martini 

Baked Apple 

Bcc Singer 


fh 

Ingredients^ 

Lorom ipsum 
lannol, cqn^oc 
adi pricing pej 
ciusmod torriq 

Beetle Juice 

Lorem Ipsum 


lamai, 

Black Eyed Susa 

Adlpl$tdng 


aliJfimod tempi 

Blue Dog 


Bookmaker's Luc 





y° U P U5 ^» a view 
USm 9 P^hl/icwCo^i I ， 

^ ihc side Of y ou vi ^w 

a ” ㈣ 《 u 匕/一如 








t 於 



like adding or editing items 


views ■/■« U j- 


We’re going to use a modal view when users want to add a new drink 
to DrinkMixer. They have to either save the added drink or discard 
(cancel) it before they can return to the main DrinkMixer app. So we 
want a view that encourages the user to make that choice. 
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plists and modal views 


Awy view caw present a modal view 


Up until now, we’ve presented new views using our Navigation Controller. 

Things are a little different for modal views: any UIViewGontroller can show 
a modal view, then dismiss it when necessary. To display a modal view on 
top of the current view, simply send the current view the presentModalView 
Controller:animated: message. Since our RootViewGontroller is the View 
Controller that needs to show the modal view, we can just send this message 
to ourselves, using self, like this: 

[self presentModalViewController : addViewControiler animated : YES]; 



V ou a»s ? lavca as a ^ 
ouv 63SC, 

AaaPv*>^\/>c^Co^oiicv. 


‘m ouv* 63SC) 



Update the RootViewController.m file to display our AddDrinkViewController 
when the + button is tapped. 


Import the AddDrinkViewGontroller.h so the RootViewGontroller knows what class 
you’re talking about. 


Change the addButtonPressed:sender: method to create an AddDrinkViewController, 
and present it as a modal view. Be careful about your memory management — don’t 
leak references to the controllers. 
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create your modal view 



Update the RootViewController.m file to display our AddDrinkViewController in 
a UINavigationController when the + button is tapped. 


#import ''RootViewController . h 1 
#import ''DrinkConstants • h 〃 

#import ''DrinkDetailViewController . h ; 




VAst 


#import ''AddDrinkViewController • h" [ W 

^ - - 匕 I 



RootViewController.m 


#pragma mark - 
#pragma mark Actions 

- (IBAction) addButtonPressed : (id) sender 
NSLog(@"Add button pressed!"); 


\i uses same ^ xd°* 


AddDrinkViewController *addViewControiler = [[AddDrinkViewCdntroller 
alloc] initWithNibName : @ 〃 DrinkDetailViewController 〃 bundle : nil]; 

[self presentModalViewController : addViewController animated : YES]; 

[addViewController release]; 

} / Wow w C just hcc d ^ show ^ odd , vi< 





: he Rooti/icwCoh^oll^ Will irctaih a hew 



RootViewController.m 
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Tqst DriVQ 


Now that the add view is fully implemented, build and run the project. Make sure 
you try out all the functionality: scrolling, drilling down to details, and finally adding a 
drink. You’ll see there’s still a little work left to be done... 




After Dinner Mint 
Aftershock 
Apple Martini 
Baked Apple 
Bee Stinger 
Beetle Juice 
Slack Eyed Susan 
Blue Dog 

80 ok maker's Luck 


C.irrlcr 子 


4:54 Plfl 


Ingredient^: 


Tvy 

avouv^d) / 


Dircctipna ： 


olw e R|TjMkj^ 


SQuEaDDu 


return 


"Tou 6 V^ 

ti-tlc *to 

i\\t VcfooarA 
dv^d make siavc Vb 
Viovks. 



If your keyboard isn’t working, your 
fields might still not be editable. 

Back in Chapter 4, we had you make the fields 
uneditable in the utilities panel. If your keyboard 
isn’t appearing, try going back into Interface 
Builder and checking that the fields are now editable. 


Watch it! 


But wkat about 
after you iinisk 
typing? 
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sam can't add his drink 


Thafs great, but after I type in 
the drink, nothing happens! I can’t 
get the view to go away, and I can’t 
add the drink. 




That’s a problem. 

Actually, it’s two problems that are related. 
Earlier, we decided that the add drink detail 
view needs to go away one of two ways: 
either the user cancels out or saves the 
drink. We need to get those buttons in there. 
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plists and modal views 


APP LAYOUT CONSTIUJCIION 




How should we lay out the Save and Cancel buttons? Is there 
anything unique about this view that we have to deal with? 




Youv- look like 

tWis aUcv- youve mitred 
youv- d/mk (a^d you cavy t 

Ao 七七灼。……） 
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we need a navigation bar 


Our modal view doesn't have a 
navigation bar 


To be consistent with the rest of DrinkMixer, we really should put the save and 

cancel buttons at the top of the view in a navigation bar. The problem is, we don’t fl 如 ^ ov C\rs the 


have one in our modal version of the detail view. 

Drink detail view 



Cupet 


Glend 


The detail ■ _ A 

Los^A 

View IS 〆 - < 

fushed oh 
"tof <^P the 
table view, 
f\rcscv-vii 
the Wav 
Coh-tv-ollc\r. 



Ingredients: 

Lorem ipsum dolor sit er el it 
lamet, consectetaur cillium 
adipisicing pecu, sed do 
eiusmod tempor incididunt ut 

Directions: 

Lorem ipsum dolor sit er el it 
lamet, consectetaur cillium 
adipisicing pecu, sed do 
eiusmod tempor incididunt ut 




dohtv-ol. 

Add drink detail view 



We could add one by hand, but remember we’re sharing the detail drink view 
nib, which gets its navigation bar from the navigation controller. Since we’re 
showing the add drink view as a modal view, we cover up the navigation bar. 

Instead of trying to solve this from within the detail drink view nib, we can 
embed our add drink view in a Navigation Controller of its own, like this: 




WC 
CV. 


TW»s Will add a Kav 
Co^tv-ollcv 〜矸 
i\,t add dvmk v，cv/. 


UINavigationController *addNavController = [[UINavigationController 
alloc] initWithRootViewController : addViewController]; 
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plists and modal views 






this! 




-( 工 BAction) addButtonPressed : (id) sender 

NSLog(@"Add button pressed!"); 


Allocate U|Nav^a-tio^Co^ollcr 
and pass m ouv" ddd\AowCoh*b"oll cyr as 
•rts rooi View Co^broWtr. \i will ^ta'm 
i\,t wbvoller, s\ut *rt ^ttds *to display 

"it 

AddDrinkViewController *addViewController = [[AddDrinkViewController 
alloc] initWithNibName : @ 〃 DrinkDetailViewController 〃 bundle:nil]; 

UINavigationController *addNavController = [[UINavigationController 
alloc] initWithRootViewController : addViewController]; 


[self presentModalViewController : addNavController animated : YES] 

; r\ A/ow wc just h eed h> show the social v, cw - 

Roo-t^cwCo^oll^ is a \/icwCo^oll 

^ P^^odaH/icwCohivoll 
handles the vest. 


[addViewController release] 
[addNavController release]; 


vicw- 

V, 

cv*, ahd 



A dIWl/,ewC 。士 。^如 d the li 3 K ：。 士 0 || 饮, 



RootViewController.m 




Table View 





Vow we just neect to 
create tkose buttons •“ 
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creating ui controls in code 

Create the Save and Cancel buttons 

Since both the Save and Cancel buttons need to dismiss the modal view ， let’s 
start by wiring them up to do that. We’ll need some actions, and the buttons 
themselves. We’ve covered how to do that in Interface Builder — and you can 
do that now if you want, but this time, let’s write them in code so see how that 
approach works. 


- (IBAction) save : (id) sender; 

- (IBAction) cancel : (id) sender; 


n ：l5：H beW 


Since we’re using the navigation bar, we get built-in support for left and 
right-hand buttons. We just need to create those buttons and assign them to 
our leftBarButtonltem and rightBarButtonltem to place them where we want 
them. 


Add a v»c^P'»dLoad 





AddDrinkViewController.h 


^ ou, i Wo 
b ^ttohs i h to ^ t 


- (void) viewDidLoad { 

[super viewDidLoad]; 

self.navigationltem.leftBarButtonltem = [[[UIBarButtonltem 
alloc] initWithBarButtonSystemltem : UIBarButtonSystemItemCancel 
target : self action : @selector(cancel : )] autorelease]; 

self.navigationltem.rightBarButtonltem = [[[UIBarButtonltem 
alloc] initWithBarButtonSystemltem : UIBarButtonSystemItemSave 
target : self action : @selector(save : )] autorelease]; 




AddDrinkViewController.m 


as cx 


pli^itly 
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Write the Save and Cancel actions 

When the user clicks either Save or Cancel, we need to exit the modal 
view by asking the View Controller that presented the view to dismiss it. 
However, to make things easier, we can send the modal view the dismiss 
message, and it will automatically forward the message to its parent 
View Controller. Since the AddDrinkViewGontroller is the modal view 
and gets the button call back, we can just send ourselves the dismiss 
message and the controller stack will handle it correctly. We need to 
send ourselves the dismissModalViewControllerAnimated: message, 
like this: 

[self dismissModalViewControllerAnimated: YES]; 


d Cartel me 七 Ws 


^ ^ dvmk out v/orks. 


#pragma mark - 

#pragma mark Save and Cancel 






this at the bot-fcom o-f 

the -Pile- 


(IBAction) save : (id) sender { 

NSLog(@"Save pressed!"); 

[self dismissModalViewControllerAnimated: YES] ; 

S'mtc >wc 3v*c m 七 he modal v*ic>w> dismiss 
message Will be dWeyted uf *to our fair ⑶七 

\/*lCy/ Coir>*tv*ollcV*> Y/hldh V/lll 3d*tu3lly rwdkc 
NSLog(@"Cancel pressed! ”）； Vicy/ a >way. 

[self dismissModalViewController Animated : YES] 


一 (IBAction) cancel : (id) sender { 


'•〆 


AddDrinkViewController.m 


Now ， to see ii tkose tuttons work … 
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your modal view works 



TesT DriVq 


The modal view can be dismissed now, and the keyboard works, too! 



□ 


All Ouitpiit t 

巧 “ ⑶ t 二二 : x ^r apple - 

知咐 0 ?二 = 6!17 . 756 — ri 贿 s 圳咖 
P ^ s ；：, 3 ： 01 10：16i22 ^ 6 卟 ―⑽〜 207 】^ 

b^o'^pressed? 6124,004 Ori ^Hix*rfl3375 ： 207j Add 
^\ 03 ^ 5 ^^ ：24 - 866 °-^ H ixerfl 397S;2a7J 


Congratulations, the 
modal view is 
orbing! 

You did a lot of view manipulation 
in this chapter and have a solid 
foundation of an application to 
show for it. You can transition to 
and from detail views and jump 
into modal views when you need the user to complete 
a specific task. Next, we just need to tackle saving the 
new drink. 
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plists and modal views 



Why don’t we need an outlet for the Save/Cancel button? And what about Interface 
Builder? 

We don’t need to do anything with the Save and Cancel buttons after we’ve created them (like 
disabling one, or swapping one out for something else briefly), so we create them and immediately hand 
them off to our navigationltem to put in the upper left and upper right. If we needed to do anything with 
them later, we’d probably want to hang onto a reference, and we could use an instance variable for that. 

As for Interface Builder, we created the buttons in code this time. Depending on what you’re trying to 
do with a control, sometimes it’s easier to just create them (or set sizes or configure controls, etc.) in 
code. For many developers, it’s just personal preference. In our case, we only needed to create simple 
buttons, so we did that in code. We didn’t need any 旧 Actions because when creating the buttons 
programmatically, you can pass in a selector (using the @selector (… ） syntax) that should be called. 
That’s how we hooked the buttons up to our Save and Cancel methods. 



So can I add some new drinks yet? I just learned how 
to make this cool new one from another bartender and 
want to put it in my app. 


To te continuect... 
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iOSdev cross 



iOSDev cross 

Using all the stuff you’ve learned about how to work 
with different plists and views, fill in the puzzle. 



Across 


Down 


1. User_on itunes stick with the app even 

after a new version is released. 

3. The navigation controller has support for_ 

buttons to fix stuff. 

5. A_view has to be dealt with by the user 

before doing anything else. 

6. Use these to organize names of things. 

7. You can create_bars in IB or in code. 

8. A nib file has Ul_. 

9. The HIG requires some kind of_element in 

a cell if there is more information availible. 


2. Views can be_and extended like any other 

class. 

4. An_specifies what a button should look 

like. 
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plists and modal views 



Your iOS Toolbox 


You’ve got Chapter 5 under 
your belt and now you’ve 
added plists and modal views 
to your toolbox. For a complete list 
of tooltips in the book, go to httpsllwww 
.headfirstlabs.comlbookslhfiphonedev. 




l-p you khov/ v/hcvc youv pvoblcm is likely 
-to be, sc*t the bveakpom-t 

You tav\ use i\\c -to step 七 Wou 吵 

-bhc pvoblcr^ av-ca- 

|-p youv d^li^d*bioh docs dvdsli, ^3y dose 
3*t*bcirv*tioirv *to *tliC Cd\\ s*t3dk- Yl>uV toAt 
-Pvarwcs av-c m bla^k; -fvar^cv/ovk Code 
(Code v/i*thou*t souvdc) is *m yrOj. 


AppSWc Busies 

l , 即 P io 士 he 

m T ° __ 

2- Approvals £a , iak e i inie> So t 

^ 9 ^ H 9 hi wiih ihc Usi 7 
submission. 

l L 0uc y° uv * 5 PP up 4 ^ sal c； 

七 ^，ews s^ay wiih ii CVCh with 

u pdatcs. 


0 “ ? 沾 

?^ s oi? Adtd 

|vse N 咖岬 W _ 
: i rc' 一七 . 


Vicv/s 

A^rc -typidally used'm a view stadk wi*th 
d Navigation Corrbrollev* o\r preserrted 

modally. 

Can be subclassed ar\d extended like 
ar\y other dlass. 

Moddl views help domnauhida-tc to a 
user *tha*t *thcy have -to dorwplrtc 9 
dis*tmd 七 task o\r abdr\dor\ rb errtively. 


■ 


9 自 HJS 
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iOSDev cross Solution 



Across 


Down 


1. User_on itunes stick with the app even 

after a new version is released. [REVIEWS] 

3. The navigation controller has support for_ 

buttons to fix stuff. [EDITING] 

5. A_view has to be dealt with by the user 

before doing anything else. [MODAL] 

6. Use these to organize names of things. [CONSTANTS] 

7. You can create_bars in IB or in code. 

[NAVIGATION] 

8. A nib file has Ul_■ [COMPONENTS] 


2. Views can be_and extended like any other 

class. [SUBCLASSED] 

4. An_specifies what a button should look 

like. [IDENTIFIER] 
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6 saving, editing, and sorting delta 


Everyone’s an editor". ♦ 



Displaying data is nice, but adding and editing information is 
what makes an app really hum. 

DrinkMixer is great —— it uses some cell customization, and works with plist dictionaries to 
display data. It’s a handy reference application, and you’ve got a good start on adding new 
drinks. Now it’s time to give the user the ability to modify the data — saving, editing, and 
sorting — to make it more useful for everyone. In this chapter, we’ll take a look at editing 
patterns in iOS apps and how to guide users with the Nav Controller. 


this is a new chapter 
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sam^ new drink 


Sam is ready to add a a au^ uu^ 
Red-Headed School 


Sam went to try DrinkMixer with the new add 
view and ran into problems right away. 


S3m v/3 s 

融 — avou^ - ^ 

vcadY *to add 
Wis dv'V'k- 



0OBOOOOOSQ 

qsooqooqb 

_ BOBOBOO V 


TV^C d\rtt {: \oi\s, 
jf\cld \s Kidder 
u 灼 dev 七 ^ 
kc^koavd- 



We have a problem with our 
view，since we can’t get to 
some of the fields. 



-the 
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saving, editing, and sorting data 


...but the keyboard is m the way 

We’re back to the keyboard problem we saw earlier with InstaEmail. 
When Sam taps on a control, it gets focus (becomes the first 
responder) and asks iOS to show the keyboard. Generally, that’s a 
good thing. However... 












^ had a simil 

whcirc ihc uscv 
^ouldh^t get io ihc 。士 o| s 
uhdev -the keyboard. 


, m so〆 ^ 

A ^ ^ 


Yt ^ 


& 


、3>八 



How did we deal with the keyboard last time? Will that work this time? 
What do you want the view to do when the keyboard appears? 
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scroll view up close 



How did we deal with the keyboard last time? Will that work this time? 
What do you want the view to do when the keyboard appears? 


Rcsijhih^ rcspohdcv ； worked last 七 —? '. 卜 .P—k/VIi.W? !七 V c f . 七 h?.-field, but 

wKa*t about *thc div-ed*tiOhs dhd -the m^redierrts -fields? /\ s sooh ds *thc keyboard domes up, *thcyVc 
Covered. The user has a smallev sdrcer\ bo work wi*th otitt *the keyboard shows up—y/c Y\ttd bo sc*t up 
*thc vicy/ *bo scroll -thmjs *m y/hch *thc user heeds -them. Wt C^y\ do -this y/i 七 h a U|Sd\roll\/icy/. 



XJI^cpallA^ew Tip Cl^se 


UI Scroll View is just like the basic UlView we’ve been using except that it can handle having items (like 
buttons, text fields, etc.) be off the screen and then scrolling them into view. The scroll view draws and 
manages a scroll bar, panning and zooming, and controlling which part of the content view is displayed. 
It does all of this by knowing how big the area it needs to show is (called the contentSize) and how much 
space it has to show it in (the frame). UlScrollView can figure out everything else from there. 








ws 








Cov\*tvoU 

(Wtto ⑽， 


TV^C sdvoll V»CY/ adts like a 

v- lC v/, so -tv^at o^\y a ， s 

v,s,We 仫如 咖 . 


Remember, in GocoaTouch, components are subclasses of UlView. All a scroll view needs to care 
about are the subviews it has to manage. It doesn’t matter if it’s one huge UllmageView that shows a 
big image you can pan around, or if it’s lots of text fields, buttons, and labels. 


To get a scrollable view, we need to move our components into a UlScrollView instead of a UlView. 
Time to get back into Interface Builder... 
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saving, editing, and sorting data 


Wrap your content m a scroll view 

We want the user to be able to scroll through our controls when the keyboard 
covers some of them up. In order to do that, we need to add a UI Scroll View to 
our view and then tell it about the controls (the content view) we want it to handle. 



All 伙 CSC 

Y\ttd -to be 

dWildvcv' 

七 he sdvoll v'»cv/. 、 


DrinkMixer ► ^jDrinkMixer A 7 DrinkDetailViewController.xib Vie 


You’ve got a point. 

Remember when we said sometimes 
Interface Builder makes things (a lot) 
easier? This is one of those times... 


The s^oll view 

^ds -to hold 

"these ^oi^pohCh-ts 
how. 


-fV^c s6voll v'»c>w ^ 

of 七 k 

w mus 七 hav ^tvoD- 


_ DrinkMixer - DrinkDetailViewController.xib 


This 


really 


is 


you 


mean 


annoying 


we 


have to pull all those components 
off and then lay out the view again? 


Isn't there 


way? 


easier 


an 


Q Objects 


Name: 


DrinkMixer 


Text View 


Text View 


Label - Directions: 


Label - Ingredients: 


Ingredients: 


Lorem ipsum dolor sit er el it 
lamet, consectetaur cillium 
adipisicing pecu, sed do 
eiusmod tempor incididunt ut 


Directions: 


Lorem ipsum dolor sit er el it 
lamet, consectetaur cillium 
adipisicing pecu, sed do 
eiusmod tempor incididunt ut 


Text Field - Name: 


0 Placeholders 


File's Owner 
First Responder 


Running DrinkMixer on iPhone Simulator 
No Issues 
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scroll view construction 


EASY GUI RECONSTRUCTION 


Apparently we aren’t the first people to realize after 
we’ve built a view that it needs to be scrollable. 
Interface Builder has built-in support for taking an 
existing view and wrapping it in a UlScrollView. 


ingrcd^nls -： ^ : _ 

Lorono ip^u m dolpr or cl it 
Eamet. consectelaur dillium 
^dipisicing pecu R do 
cjy^mqd tompor incididunt ut 


DW^cMon^: 

Lorem Ipsu m dolor sit er el It 

cons 仔 cillium 

adip juicing pecu, ?ed do 
eiyfinmd lempor Incididunt u?t 


Interface Builder 
will create a 
UlScrollView just 
big enough to hold 
all our components. 
Since we want 
the whole view 
to scroll, grab the 
corners of the new 
UlScrollView and 
drag them out to 
the corners of the 
screen, right up 
to the edge of the 
navigation bar (we 
don’t want that to 
scroll). 


Highlight all the widgets (as shown 
here) in the detail view, then go to the 
Editor^Embed^Scroll View menu option. 
Interface Builder will automatically create a new 
scrolled view and stick all the widgets in the same 
location on the scrolled view. 

Rl Drink Details 



Tl 


Ingredients: 

Lorem ipsum dolor sit er elit 
lame!, consectetaur cillium 
adipisicing pecu, aed do 
eiusmod temper incididunt ut 

Directions: 

Lorem ipsum dolor ait er elit 
lamet, consectetaur cillium 





|v(ov/ y ou haa 七 ^ 

same listrn^ 

as bcW, 

W 七七 W ave 
u^dev a sdvoll v 心 . 


How will this new scroll view know how much 
content needs to be scrolled? 
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saving, editing, and sorting data 


The scroll view is the same size as 
the screen 


Interface Builder created the UI Scroll View, but there are a few 
finishing touches necessary to make this work the way we want. 
You need to tell the UI Scroll View how big its content area is 
so it knows what it will need to scroll — you do that by setting 
its contentSize property. Then you’ll need to add an outlet and 
property for the UI Scroll View, then wire it up in Interface Builder 
so we can get to it. 

So how do we figure out how big the contentSize should be? 

When the UI Scroll View is the same size as our screen, we don’t 
have anything outside of the visible area that it needs to worry 
about. Since the scroll view is the same size as our UlView that it’s 
sitting in, we can grab the size from there, like this: 

scrollView.contentSize = self.view.frame.size; 

Once you’ve added that line, you’ll have a scroll view that takes 
up all of the available space, and it thinks its content view is the 
same size. 



ter 如吒 ‘ 




h> 


^Sharpen your pencil 


Update DrinkDetailViewController.h and DrinkDetailViewController.m to 
handle our new UlScrollView. 


o 

O 

❺ 


Add an attribute named scrollView to D rinkD e tail Vie wGontroller to hold a reference 
to the UlScrollView. You’ll need the field declaration and IBOutlet property, then you 
will synthesize it in the .m and release it in dealloc. 

Wire up the new property to the UlScrollView in Interface Builder by adding a new 
Referencing Outlet to the UlScrollView connected to your scrollView property. 


Set the initial contentSize for the scrollView in viewDidLoad:. Remember, we’re 
telling the scrollView that its content is the same size as the view it’s sitting in. 
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start scrolling 


Sharpen your pencil 
,Solution 




Update your DrinkDetailViewController.h and 
DrinkDetailViewController.m to handle our new UlScrollView. 



Add an attribute named scrollView to DrinkDetailViewGontroller to hold a reference 
to the UlScrollView. You’ll need the field declaration, an IBOutlet property, to 
synthesize it in the .m and release it in dealloc. 


Qinterface DrinkDetailViewController : UlViewController 
Qprivate 

UITextField *nameTextField—; 

UITextView *ingredientsTextView_; 

UITextView *directionsTextView_; 

NSDictionary *drink_; 

UlScrollView *scrollView ; 




©property (nonatomic , retain) IBOutlet UlScrollView *scrollView; 





set 







DrinkDetailViewController.h 


@synthesize scrollView=scrollView 




0lc3h up ouv* 

i h dcalU. 




(void)viewDidLoad { 


Set the ihi-tial 

[super viewDidLoad]; 
self.scrollView.contentSize = self. 
view.frame.size 



- (void)dealloc 


[scrollView 一 release ], 

[nameTextField_ release] 

[ingredientsTextView_ 
release]; 



k 


DrinkDetailViewController.m 
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saving, editing, and sorting data 


❺ Wire up the new property to the UI Scroll View in Interface Builder. 




DrfnkMiyer - DrlnkOeiailVSewCofiircKlIer.KJb 



DTin 氅 Miwei i ^j0rinkMi3i»i ^ Drinh[>f!CjilViewCun*lr?llcr.?i.!b Vlw Strgll Viltv 



0 PlAccl»lders 


Nle~a Uwncr , 

擊 FaiiiC 


存 OUsiiK.E& 



Viw 


1 I«k£ View 
Libel - Dirc4 
Test View 


•detepiiE- 

Rjfpr#nrltvg Ouitif« 

HJOllVIW ■ Pilv'iL Civ 

Mnr hvTtnmirfy Ovll«t 
HcfErEncinf Oullei CdlKtJum 

Mrw BrlVrwnfku C^lH-tlnA 


n dDbr sit m allt 
(petetaur dllium 
jqcu , 帥 d do 
eiusmod temper incididunl ut 


Tesr DriVq 


lilalil 画 

且 m 

^rraU Vifw 


9 


Strull 她 DgfjuU 
Sui^lei& 5? ShiiwTi S^rullcu 

gSHmfi VenkJ^FvIkri. 

'也 ^Trailing Fnjkhl^d 

M Paging iF^inhANi 
Q CHrectKHt Lock Lnabted 
Bounces 
Q Alwivii I 
Q Alwdyi Bvunt.c Wfliq.dllf 

Toom '~ I.IMJ I? 

Min _ 

Tmifh Fkiunm : 

?! Dcliiys CDfitcnE Pouctiei 
C-anctllab^c Conten? l-o.. 





Tap in tke text iielct 
and tke keyLoarct 
appears...tut notliing’ 
scrollingf! 


s 





Why isn’t it working yet? Think about all the things 
that you have going into this view — the scroll view, 
the main view, and the keyboard... 


you are here ► 259 

















































keyboard means changes 

The keyboard changes the visible area 

The problem is that the keyboard changes the visible area but the scroll 
view has no idea that just happened. The scroll view still thinks it has 
the whole screen to display its content, and from its perspective, that’s 
plenty of room. We need to tell the scroll view that the visible area is 
smaller now that the keyboard is there. 





»s -tv^c same as 7 
sC ro\\ 

,s i\^t ^o\t Sdvcew，. 


...WU — 如 a??^s 

over -tV,e sd.oll a^ove^ ? 

fe ,ttd bo tell tV,e 咖 1 _ ，七 


a 
Wc 


Sd\roll view 


o 


iOS tells you about the keyboard, but 
doesn’t tinker with your views. 

Just because iOS knows that the keyboard is 
there, it doesn’t know how your app wants 
to handle it. That’s up to you! 
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you are here ► 


261 






iOS notifications 


iOS notifies you about the keyboard 

Interacting with the keyboard and the scroll view brings us to a part 
of the iOS we haven’t talked about yet called Notifications. Just 
like component events being passed around our application, there are 
system-level events, called Notifications, that are being passed by iOS. 
The secret to knowing what’s going on with the keyboard is knowing 
about these events. 



Sam taps in the Drink 
name field and the 
field becomes the first 
responder. Now the 
iOS needs to show the 
keyboard. 


❺ The iOS posts a notification to the 

default NSNotificationG enter named 
UIKeyboardDidShowNotification. 


Event 

Object 

Selector 

UIKeyboardDidShowNotification 

DetailDrinkViewController 

keyboardDidShow 











NSNotificationCenter 



The N SN otificationG enter 
invokes the target selector 
and passes it information 
about the object that 
triggered the event, along 
with event-specific details. 

[registeredObject 
keyboardDidShow : eventlnfo] 




N SN otificationG enter looks up the 
event to see if anyone is registered 
to be told when that event happens. 
Objects are registered by providing a 
selector (method) to call if the event 
is triggered. 
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Register with the default wotificatiow 
ccwtcr for events 

iOS supports more than one NSNotificationGenter, but unless you have 
specific needs for your own, you can just use the default system-level one. You 
can get a reference to the default one by calling this: 

[NSNotificationCenter defaultCenter]; 

With the notification center, you can register for events by passing the object 
you want the notification center to call back to (usually yourself), the method 
to call, an event you are interested in (or nil for any event), and, optionally, the 
sender you want to listen to (or nil for all senders). 


S 土碎以 — 



Wlc -the ir>oii-Pidaiio^ Uv\icy io 

tall us ("the DetdilDv’mkl/iewCoirbrollev*), 
so wc pass scl-f \v\ ds the obsewev-. 



[[NSNotificationCenter defaultCenter] addObserver : self selector : @ 
selector(keyboardDidShow:) name : UIKeyboardDidShowNotification object : nil]; 


Jfvoma metw ^ 


A 


七 & 6ol ° 於 

V^cvc, bcdausc 70UVC 50^5 
^ act about tV^c 




then uwrcgistcrwhcM you're done 


Just like memory management, we need to clean up our registrations 
from the notification center when we don’t need them any longer. We’ll 
register for events in viewWillAppear: and unregister in viewWillDisappear:. 
Unregistering for an event is easy~just ask the notification center to 
removeObserver for the object you registered. 


[[NSNotificationCenter defaultCenter] 

su^rc you 

W the sar, C ho-ti^i^io h 
you ircgis-t^ccl with. 


removeObserver:self]; 


C 故一 f 

t ㈣ 二一， 
3S 
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The cen^ev exposed 

This week’s interview: 

Why do you talk so much? 


Head First： Um, this is embarrassing, but I’m not 
entirely sure I have the right Notification Center 
here... 

Notification Center： Well, unless you need 
something weird, it’s probably me. I’m the guy 
everybody goes to by default. Heads up! An app’s 
shuttin , down. Be with you in a second. 

Head First： Wow — so you know about every app 
that starts and stops? 

Notification Center： Yup. I’m the default center; 
all the system events go through me. Now, not 
everybody is interested in what’s going on, but if they 
want to know, I’m the guy to see. 

Head First： So when someone wants to know 
what’s going on, they tell you what they’re interested 
in, right? 

Notification Center： Exactly. If somebody wants 
to know about somethin’ in the system, they register 
with me. They tell me the notification they want me 
to watch for, who I should tell when it happens, and, 
if they’re really picky, who should have sent it. 

Head First： So then you tell them when that 
notification happens? 

Notification Center： Right — they tell me what 
message to send them when I see the notification 
they were interested in. I package up the notification 
information into a nice object for them and then call 
their method. Doesn’t take me long at all; the sender 
almost always waits for me to finish telling everyone 
what happened before it does anything else. 

Interviewer： Almost always? 

Notification Center： Well, the sender could 
use a notification queue to have me send out the 
notifications later, when the sender isn’t busy, but 
that’s not typically how it’s done. 

Head First： Hmm, this sounds a lot like message 


passing. The sender wants to tell somebody that 
something happened, you call a method on that 
somebody".what’s different? 

Notification Center： It’s similar to message 
passing, but there are some differences. First, the 
senders don’t need to know who to tell. They just tell 
me that something happened and I’ll figure out if 
anyone cares. Second, there might be lots of people 
interested in what’s going on. In normal message 
passing, the senders would have to tell each one 
individually. With notifications, they just tell me once 
and I’ll make sure everyone knows. Third, unlike the 
delegate pattern — where the message gets sent to 
only one object — I can send messages to any number 
of objects. Finally, the receiver of the notification 
doesn’t need to care who’s sending the message. If 
some object wants to know that the application is 
shutting down, it doesn’t care who’s responsible for 
saying the app’s quitting, the object just trusts me to 
make sure they’ll know when it happens. 

Head First: So can anyone send notifications? 

Notification Center： Sure. Anybody can ask me 
to post a notification and if anyone’s registered to get 
it, I’ll let them know. 

Head First： How do they know which notifications 
to send? 

Notification Center: Ah, well that’s up to 
the sender. Different frameworks have their own 
messages they pass around; you’ll have to check 
with the framework to see what they’ll send out. If 
you’re going to be posting your own notifications, 
you almost certainly don’t want to go blasting out 
someone else’s notifications; you should come 
up with your own. They’re just strings — and a 
dictionary if you want to include some extra info — 
nothing fancy. 

Head First： I see. Well, this has been great, 
Notification Center. Thanks for stopping by! 
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So registering for the keyboard event 
sounds pretty easy, but there's more to do 
after that, right? 


Exactly. 

We need to tell the scroll view what to 
do once the keyboard does pop up (and 
when it goes away). 


t^harpen your pencil 


Fill in the blanks and get a plan for the next step! 


We need to 


for the 


and 


events m 


We’ll add two that will be called by the 


when the notifications are posted. 


We’ll adjust the size of the 


when the keyboard appears and disappears. 


We need to for events in 


Bonus Question: What file will you put all these changes in? 
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sharpen solution 


Now you have a plan for what to do next. 

We need to.for the U l^cyboar dDi dShoy/No-ti-f i^a*tioh 

and (/f l^^yboardDidWideNoti^fi6a*tion events in 

We’ll add two ^C*thods that will be called by the ho*ti*f ida*tioh dCh*tcV" 

when the notifications are posted. 

We’ll adjust the size of the scroll viev/ when the keyboard appears and disappears. 

We need to for events in viewl/VillPisappcav- 

This Code heeds *bo go m*bo AddP^^kl/icy/Coh-tv-ollcr, smde *th3*t ； s -the o^ly vicy/ where y/cVc gomg 
bo be us'mg {\\t keyboard. 


r t^jarpen your pencil 

Solution 


Q/ I can’t find the list of notifications 
that are sent by the iOS. Where are they 
listed? 

There isn’t a central list of all the 
notifications that could be sent. Different 
classes and frameworks have different 
notifications they use. For example, the 
UI Device class offers a set of notifications 
to tell you about when the battery is being 
charged or what’s happening with the 



proximity sensor. Apple’s documentation is 
usually pretty clear about what notifications 
are available and what they mean. The 
keyboard notifications are described in the 
UlWindow class documentation. 

Why would I want to create my own 
notifications? 

It depends on your application. 
Remember, notifications let you decouple 
the sender from the receiver. You could use 


this in your application to let multiple distinct 
views know that something happened in your 
application. 

For example, let’s say you had a view 
that let you add or remove items from 
your application and your app has several 
different ways to view those things. 
Notifications could give you a nice way 
to announce to all the other views that 
something has changed without your add/ 
remove view needing to have a reference to 
each of them. 
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Go ahead and make the changes to your code to register 
for the keyboard events. We’ll implement the code to handle 
the scroll view shortly. 



Add keyboardDidShow and keyboardDidHide methods to the 
AddDrinkViewController. 

For now, just have them print out an NSLog when they are called. We’ll add the 
meat in a second. Both methods should take an NSNotification*, as they’ll be 
called by the notification center and will be given notification information. 



Register for the UIKeyboardDidShowNotification and 
UIKeyboardDidHideNotification in viewWillAppear(...). 

You should use the default NSNotificationGenter and register to receive both 
events regardless of who sends them out. 



Unregister for all events in viewWillDisappear(...). 

Create this method and use it to add the code to unregister for events. 


o Add a BOOL to AddDrinkViewController that keeps track of 
whether the keyboard is visible or not. 

We’ll talk more about this in a minute, but you’re going to need a flag to 
keep track of whether the keyboard is already visible. Set it to NO in your 
viewWillAppear (…） for now. 
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ExeRciSe 

SotutioH 


Go ahead and make the changes to your code to register 
for the keyboard events. We’ll implement the code to handle 
the scroll view shortly. 


These both hew methods -Pov- the 

keyboavd hoti-Pi^atiohs ih the i^plc^ch-btioh 
+ile. We II get io those a 


- (void)viewWillAppear : (BOOL)animated 
[super viewWillAppear : animated]; 

NSLog(@"Registering for keyboard events"); 

[[NSNotificationCenter defaultCenter] addObserver : self selector : 
selector(keyboardDidShow:) 

name:UIKeyboardDidShowNotification object:nil]; 

[[NSNotificationCenter defaultCenter] addObserver : self selector : 
selector(keyboardDidHide : ) 

name : UIKeyboardDidHideNotification object : nil]; 

// Initially the keyboard is hidden, so reset our variable 
keyboardVisible = NO; Je— 




I/Ve b> keep *tv-adk of keyboavd is 

sV>ov/iirk^ o\r yV|oV*C oy \ *tKis \ y \ 3 mnr>u*tc- 




- (void)viewWillDisappear : (BOOL)animated { 

NSLog(@"Unregistering for keyboard events"); 

[[NSNotificationCenter defaultCenter] removeObserver:self]; 

} 

#pragma mark - 

#pragma mark Keyboard handlers 

- (void)keyboardDidShow:(NSNotification *)notif { 

NSLog(@"Received UIKeyboardDidShowNotification. r, ); 

} 

- (void)keyboardDidHide : (NSNotification *)notif { 

NSLog(@"Received UIKeyboardDidHideNotification."); 




ddDrinkViewController.m 


@interface AddDrinkViewController 
BOOL keyboardVisible ; 


DrinkDetailViewController { 


(void)keyboardDidShow : (NSNotification *) notif; 
(void)keyboardDidHide : (NSNotification *) notif; 


AddDrink 



AddDrinkViewController.h 
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Keyboard events tell you the keyboard 
state and size 


The whole point of knowing when the keyboard appears or disappears 
is to tell the scroll view that the visible area has changed size. But, how 
do we know the new size? Thankfully, the keyboard notification events 
(UIKeyboardDidShowNotification and UIKeyboardDidHideNotification) 
include all the information we need. 


domes YiVth a , 

如 ” 邱也 y 




name = UIKeyboardDidShowNotification 


f' NSNotification | 
object 




object = relevant object or nil 



userlnfo 









We 一 r u e 

匕 HP ⑽：二“ 

avea. 


Tke keytoarct size is 
in tke NSNotiiication 
otject* 



Getting the notification is easy, but we get told every 
time the keyboard is shown, even if it’s already there. 

That’s why we need the BOOL to keep track of whether or not the 
keyboard is currently displayed. If the keyboard isn’t visible when we 
get the notification, then we need to tell our scroll view its visible size 
is smaller. If the keyboard is hidden, we set the scroll view back to full size. 
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keyboard magnets 


// 



Ke^toard Code Magnets Part I 

Below are the code magnets you’ll need to implement the 
keyboardDidShow method. Use the comments in the code 
on the right to help you figure out what goes where. 


NSDictionary *info = [notif userlnfo]; 


CGRect viewFrame = self.view.bounds; 

viewFrame.size.height = keyboardTop - self.view.bounds.origin.y; 




NSValue *aValue = 

: [info objectForKey : UIKeyboardFrameEndUserlnfoKey]; | 


self. scrollView. frame = 
keyboardVisible = YES, 


viewFrame 


• f KeyboardVisible ) / 

: S:( Key£o 咖 

return; 


is 


ready vi 


visible 


工 gnorin 


g 


CGRect keyboardRect = [aValue CGRectValue]; 

keyboardRect = [self.view convertRect : keyboardRect fromViewrnil ]； 
CGFloat keyboardTop = keyboardRect.origin.y; 
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(void)keyboardDidShow : (NSNotification *)notif 


// The keyboard wasn f t visible before 


// Get the origin of the keyboard when it finishes animating 


// Get the top of the keyboard in view's coordinate system. 

// We need to set the bottom of the scroll view to line up with it 


//Resize the scroll view to make room for the keyboard 




AddDrinkViewController.m 
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Ke^toarJ Code Magnets Part II 

Below are the code magnets you’ll need to implement the 
keyboardDidHide method. Use the comments in the code on 
the right to help you figure out what goes where. 




NSLog(@"%@",@ "Resizing bigger with no keyboard’’），- 
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AddDrinkViewController.m 
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keyboard magnets solution 


f ㉞ 


Keyboard Code Magnets Part I Solution 

Below are the code magnets to SHOW the keyboard. 



- (void)keyboardDidShow:(NSNotification *)notif 


if (keyboardVisible 一） { 

NSLog(@"%@",@ "Keyboard is already visible. Ignoring 
notification. ; Wc W\W yt *tK*is whchcvcv- *tKc uscv sw*i*Uhcs 

return; it%i -fields, \( *thc keyboard *is already sV>oWm} S 。 

} v/e keep *tv*adk o-f 'rt bail i-f its a vcpca*t- 


// The keyboard wasn't visible before 



// Get the origin of the keyboard when it finishes animating. 
NSDictionary ^info = [notif userlnfo]^ 


Wc 


3 扦七 he keyboaird Siz^ the ckti 时 y... 
NSValue *aValue = [info 


pull that out licvc. 


objectForKey^CJIKeyboardFrameEndUserlnfoKey]; 

// Get the top of the keyboard in view's coordinate system. 

// We need to set the bottom of the scroll view to line up with it 

CGRect keyboardRect = [aValue CGRectValue]; 

keyboardRect = [self.view convertRect : keyboardRect fromViewrnil] 
CGFloat keyboardTop = keyboardRect.origin.y; 

//Resize the scroll view to make room for the keyboard 

CGRect viewFrame = self.view.bounds; 

viewFrame.size.height = keyboardTop _ self.view.bounds.origin.y ； 


self.scrollView.frame = 
keyboardVisible— = YES; 


viewFrame; 


… 七 -fijuv-c out b'15 tKc 
sdv-oll view v-cally (basically 
\\o^n bi<\ our view is, m'mus {\\t 
keyboard). 


SIZjC 


pmally, update *tV>c sdvoll viow W\{\\ *tV>c v\t^ 
siz^ av\A mark 七 ha 七 tKc keyboard is visible. 
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Ke^toarJ Cocte Magnets Part II Solution 

Below are the code magnets to HIDE the keyboard. Handling the 
UIKeyboardDidHideNotification works almost exactly the same way, except 
this time the scroll view needs to be expanded by the size of the (now missing) 
keyboard. 


(void)keyboardDidHide : (NSNotification *)notif 


if (!keyboardVisible_) { 

NSLog(@"%@",@"Keyboard already hidden. Ignoring 

notification.^); 


return; 


// The keyboard was visible 





// Resize the scroll view back to the full size of our view 







sdvoW ^ ^ 


i\\t ^ 


visible avea- 




AddDrinkViewController.m 
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scrolling works now 




Tqst DriVQ 


Go ahead and build and run. Once you get into the detail view, you should be able to 
scroll the view to all the fields, and the messages in the console help you keep track of 
what’s going on. 



All Output i 

2011-83-01 

2011-03-01 

2011-03-91 

2011-03-01 

2011-03-01 

2011-03-01 

2011-83-01 

2011-03-01 

2011-83-01 

2011-83-01 

2811-03-01 


11:08:57 

11:09:03 

11.09:03 

11:09:03 

11:09:06 

11:09:06 

11:09.09 

11:09:09 

H ： 09:12. 

11:09:12. 

11:09:12. 


• B3Z urinnni*«ru.«t**/o: £vr j 

•052 DrinkMixer[14478 ； 207i 
•163 DrinkMixerl14478:207] 
.569 OrinkHixer[14478:207] 
.570 DrinkMixerl14478:207] 
.323 DrinkMixer[14478:207] 
335 DrinkMixerl14478 ： 207] 

641 DrinkMixerl14478:297] 

642 DrinkMixerl14478:207J 
227 DrinkNixer[14478 ： 207] 
634 DrinkHixer[14478:207] 
634 DrinkHixer(14478;207] 


ux R ey Doa ro TOran ow W o C !! a ^^^^R] 

Resizing smaller for keyboard 
Cancel pressed! 

J ； f K# y b o a r«*DidHideNotification 

Resizing bigger with no keyboard 
Add button pressed! 

Registering for keyboard events 

„ ec ® 1 Y ed UIKeyboardDidShowNotification 

Resizing smaller for keyboard 
Save pressed! 

J® C ? i Y ed UIKeyboardDidHideNotification 

Resizing bigger with no keyboard 


l 


there ^ are no o 

Dumb QjuestiQns 


Manipulating that scroll view size is 
kind of tricky—how would I have figured 
that out without magnets? 

A great reference for the code samples 
and information for programming apps 
in general is the Text, Web and Editing 
Programming Guide for iOS that is available 
on the Apple developer website. That has 
sample code for common problems like 
managing the keyboard and text views. 

Tell me again why we need to keep 
track of whether the keyboard is already 
visible? Isn’t iOS doing that? 

The iOS knows the state of the 
keyboard, but it sends keyboard events out 
when different controls get focus. So, when 
the user taps in the first field, you’ll get a 
UIKeyboardWillShowNotification followed 


by a UIKeyboardDidShowNotification. When 
the user taps into another field, you’ll get 
another UIKeyboardDidShowNotification so 
you know the keyboard focus has changed, 
but you won’t get the keyboard hide event, 
since it never actually went away. You need 
to keep track of whether you already knew 
it was visible so you don’t resize the scroll 
view to the wrong size. 

The scroll view works, but 
depending on what the users pick, they 
still have to scroll to the widget? 

Yes—and that’s not ideal. You can 
ask the scroll view to scroll to a particular 
spot on the content view if you keep track of 
which control has the focus. The Text, Web 
and Editing Programming Guide for iOS has 
good sample code for that. 

Don’t we know the dimensions of 
the keyboard that pops up? Why do we 


have to figure out the boundaries with all 
that code? Isn’t it always the same? 

It’s not always the same! If your 
application is landscape, your keyboard is 
wider than it is tall. If your app is portrait, 
then it’s taller than it is wide. And the iPad is 
a completely different size. Apple also makes 
it clear that they may change the size of the 
keyboard if necessary and you should never 
assume you know how big it is. Always get 
size information directly from the keyboard 
notifications. 

What are the animation and curve 
properties in the notification about? 

The Keyboard notification includes 
information on how quickly the keyboard is 
animating in. You can use this information to 
animate the size change of your content so 
the keyboard comes in as your content view 
shrinks. 
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Everything scrolls OK, and I can put a drink in, but as soon 
as I get back to the list, the drink I added isn’t there! 


Sam’s drink is missing. 

As soon as he leaves the drink detail view, the new 
drink no longer shows up in the main list. We need 
to figure out how to keep it around longer... 



Sharpen your pencil 



Work through the following questions to 
think about what this means for our app. 


What happens to new drinks when the user hits Save? 


Where do we need to add code? 


How are we going to save the new drink? 
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create a MutableDictionary 


^Jharpen your pencil_ 

< Solution Work through the following questions to 

think about what this means for our app. 

What happens to new drinks when the user hits save? |/Vc dismiss *thc view *thc drmk *m-forma*tioh 
is los*t- 

Where do we need to add code? VJt bo ddd some todt 七 ha 七 3d*budlly s*to\rcs 七 he values 
*tKc user ch*tc\rcdi : 

How are we going to save the new drink? S；mdc wc already s*to\rc ou\r. dlr'mks m di^iio)r\a)rics, wc 6 和 . 

d\rca*tc a hew didtiohary y/i-th the *m^ov ； ma*tjov) eihdi add i*t bp drmk array. 



We can create a new dictionary by allocing 
it, but were going to need to get a reference 
to the array from somewhere. Could the 
RootViewController help with that? 


That’s not a bad idea. 

Creating a new NSMutableDictionary is easy enough, we can 
do that by allocing and initializing it. We can set the drink 
interaction on the dictionary using setObjectForKey:. What’s 
going to take a little more work is adding it to the drink array. 
We need to give the AddDrinkViewGontroller a reference to the 
whole drink array. Let’s start by having the RootViewController 
pass the new drink in after we’ve created it. 
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Go back and update the RootViewController and AddDrinkViewController to 
support saving new drinks. 



Give the AddDrinkController a reference to the master drink array. 

You’re going to need to add a drinkArray field to the class, a corresponding property, 
and then synthesize it and release the reference in dealloc. Finally, you need to make 
sure that the RootViewController passes on a reference to the drink array when it’s 
setting up the AddDrinkController. 



Create and add a new dictionary to the array. 

You need to update the save: method to get the drink details from the controls and 
store them in a new dictionary. After that, add the dictionary to the master drink 
array using addObject:. 
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EjceficiSe 
Solution 



Go back and update the RootViewController and 
AddDrinkViewController to support saving new drinks. 


Give the AddDrinkController a reference to the master drink array. 



@ interface 

AddDrinkViewController : DrinkDetailViewController{ 


BOOL keyboardVisible_; 

NSMutableArray *drinkArray__; 

} dvmk. 

©property (nonatomic, retain) NSMutableArray *drinkArray; 





AddDrinkViewController.h 


- (IBAction) addButtonPressed : (id) sender { 
NSLog(@"%@", @"Add button pressed."); 


今 We ouv y\cy/ly AddPv-'mk\/icwCo^v-ollcv- 

a 代 W “铋如 master a^rmk a^ay W ▲ 
uscv- adds a v\t>N dvmk. 


AddDrinkViewController ^addViewController = [[AddDrinkViewControllejr alloc] ini 
tWithNibName:@”DrinkDetailViewController 〃 bundle : nil]; 

addViewControiler.drinkArray = self.drinks; 

RootViewController.m 



AddDrinkViewController.m 
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❺ Create and add a new dictionary to the array 


- (IBAction) save : (id) sender { 

NSLog @’’Save pressed !’’） 


y/c waht h> add keys a^d objedts, wc heed h> 

a ,7^ b ' c I/Vhat problems (iould you 

心 mto lat 饮 if you heated ir,r,u-bblc 咖 •_? 

// Create a new drink dictionary for the new values 

NSMutableDictionary *newDrink = [[NSMutableDictionary ailoc] init]; 
[newDrink setValue : self.nameTextField.text forKey : NAME_KEY]; 

[newDrink setValue : self.ingredientsTextView.text forKey : INGREDIENTS_ 

KEY]; 

[newDrink setValue : self.directionsTextView.text forKey : DIRECTIONS— KEY] 
// Add it to the master drink array and release our reference 


[drinkArray 一 addObject : newDrink] 


[newDrink release] 




// Pop the modal view and go back to the list 

[self dismissModalViewControllerAnimated : YES] 


use ^ vei 

dvmk arva'f- 



AddDrinkViewController.m 
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five-minute mystery 



Plve^lnute 

My^ry 


N’ 1 匕 ole, \rcady 
P 如 pem h 饮 1/j 

3 u «-ts. 


"to 

IP 



The Case of the Missing Reservations 

Nicole has been a maitre d’ at Chez Platypus since it opened 
nearly 10 years ago. This upscale restaurant has a number of 
distinguished customers who like their dining experience to be 
just perfect. The VIP guest list hasn’t changed in years and Nicole 
knows everyone’s face. She takes them right to their favorite table 
when they show up and makes sure everything is just right. She’s 
extremely efficient and the restaurant couldn’t do without her... 
that is, until her recent, tragic, mistake. 

Earlier this month, Chez Platypus got a new investor. A 
prominent, if eccentric, Nobel Prize-winning scientist who is 
known for his particular tastes. Restaurant management dug 
up the dusty VIP list and added the scientist’s name at the 
bottom, along with all the detailed instructions for making sure 
everything was “just so” when he arrived. They trusted that Nicole 
would take good care of him and didn’t give it another thought. 

Last night, their new investor arrived a few minutes before some of 
the other VIP guests. Nicole didn’t even notice him. She continued 
to move the regular VIPs to their seats and, for all she knew, their 
new investor did not even exist. 


Why mould Nicole ignore such an 
important nezv guest? 
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Tqst DriVQ 


That was a lot of code! Run the app and make sure everything is 
working. Here’s a drink to add to the list (it’s the new house drink 
in the Head First Lounge). 


卜 cl-telcfecl School GIrJ 


-this -to 

youir app. 


Cdhddidh whiskey 
C^rc^rm sodd 


// 


Add ihe ^ the soda h> a 

shot glass ahd d\rihk. 
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test drive 




Tesr DriVq 


To properly test the app now, click the Add button and enter the data for the new drink in the 
detail view. When you’re finished, click Save. 

Now, what happens back in the list view? 


■ 10^2 / AM 







| Carrier 1:54 PM 

b] 


After Dinner Mint 


Aftershock 

> 

Apple Martini 

> 

Baked Apple 

> 

Bee Stinger 

> 

Beetle Juice 

> 

Black Eyed Susan 

> 

Blue Dog 

> 

Bookmaker's Luck 

> 


1^9 


But your drink 
still Wt ， there! 
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saving, editing, and sorting data 



Something’s wrong. We implemented the Save method, created a new drink, added 
it to the array...and we’re pretty sure all that code works. Before we move on, let’s 
use the debugger and do a quick sanity check. Uncomment the viewWillAppear in 
RootViewController.m and set a breakpoint. If the breakpoints are on, it will launch the 
debugger when you run. 


X*N. 


_ DrinkMixer - RootViewController.m 

(►)DrinkMixer 


wmm e 回 




ii R O ik •=• » P 

III! 

■Ill 

◄ ► DrinkMixer > ^Classes [m| RootViewController.m No Selection 

By Queue 

Thread 1 

com.apple.main-thread 


#pragma mark • 

#pragma mark View lifecycle 


rl 1 -(UINavigationController _startTrans. 

PI 2 0 UlAppiicationMain 

021 main 

- Thread 2 

“ com.apple.libdispatch-manager 

|1 Thread 3 

II Thread 4 WebThread 


[super viewDidLoad] ; 

NSString ♦path = [ [NSBundle mainBundle] pathForResource:@"DrinkDirections" ofType: 
@"plist"] ; 

drinks_ = [ [NSMutableArray alloc] initWithContentsOfFile: path]; 
self . navigation!tem.rightBarButtonltern = self . addButton; 


七饮 lookmj a*t 

values, 

ahead ^v\d 

application 

av\A add a 
dv-'mk. CWk ou 七 
-tiic values v/\)cv\ 
Roo*t\/icv/Coir\*tv"ol I cv- 
s*tops aja'm. 


- (void) viewWillAppear: (BOOL)animated { 
[super viewWillAppear: animated]; 


■ /♦ 

I - (void)viewDidAppear:(BOOL)animated { 
[super viewDidAppear:animated]; 

H !► ^2* i ♦ I DrinkMixer ) || Thread 1 


Thread 1: Stopped at breakpoint 


Sc*t a bv-cakpo'm*t v*ic>wl/VillAffcav- 

Roo*t\/*iC>MCoy>*tv-ol lev. 

0 - [RootViewController viewWillAppear:] 


A 


All Output 


Clear 


c □ a 


self = (RootViewController ” 0x4d20470 

► UlTableViewController = (UrTableViewController) {...} 

► drinks_ = (_NSCFArray *) 0x4b3bb80 40 objects 

► addButton_ = (UIBarButtonltem *) 0x4b39910 
_cmd = (struct objc^selector *) 0x6d81a2 
animated - (BOOL) NO 
objc_super = (struct _objc_super) {•••} 

ft: 二 S 

M m W 如冰 a 叫 


GNU gdb 6.3.50-20050815 (Apple version 
gdb-1518) (Thu Jan 27 08:34:47 UTC 2011) 
Copyright 2004 Free Software Foundation, Inc. 
GDB is free software, covered by the GNU 
General Public License, and you are 
welcome to change it and/or distribute copies 
of it under certain conditions. 

Type "show copying" to see the conditions. 

There is absolutely no warranty for GDB. Type 
"show warranty" for details. 

This GDB was configured as M x86_64-apple- 
darwin".sharedlibrary apply-load-rules all 
Attaching to process 54456. 

Pending breakpoint 1 - MM RootViewController.m" : 
33" resolved 

Current language: auto; currently objective-c 


a 


■o 


What did you find? 


What’s going on? 
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exercise solution 




pcW 奶〜 


E^enciSe 
SoLutlOH 


Now we’re going to use the debugger to help us 
figure out what’s going on. 


« o o 

㈣ 


□ 

Q] DrinkMixer - RootViewController.m 



( — ) 

DrinkMixer 

mw 









ii R O 4 » 

m 

!!!i ◄ ► | \ DrinkMixer * Q Classes > [m] RootViewController.m > No Selection 


By Queue 


|| 


Thread 1 

com.apple.main-thread 


-[RootViewController 




I"! 1 - [UINavigationController viewWillAp.. 

ri4 -[UlViewController dismissModalVie.. 

] 5 -(AddDrinkViewController save:] 

□ 6 - [UlApplication sendAction:to:from:f. 

n 23 UlApplicationMain 

24 main 

Thread 2 


Q 


#pragma mark - 

#pragma mark View lifecycle 


( void) viewDidLoad { 
[super viewDidLoad] ; 




NSString *path = [ [NSBundle mainBundle] pathForResource:@"DrinkDirections M ofType: 
@ M plist M ] ; 

drinks_ = [ [NSMutableArray alloc] initWithContentsOfFile: path]; 
self.navigationltem.rightBarButtonltem = self . addButton; 


n 


com. apple.libdispatc 卜 manager 


Thread 4 WebThread 
|1 Thread 5 


*tW»s "tiw'C ou\r 
talUta^k is - 

AddPv-*mk\/*iCv/Coir\*t\rollcrs 

save ddll* 


( void) viewWillAppear: ( BOOL) animated 
[super viewWillAppear: animated]; 


I - (void)viev/DidAppear: (BOOL)animated { 
[super viewDidAppear:animated]; 

H !► Q* i i I DrinkMixer ) If, Thread 1 


Thread 1: Stopped at breakpoint 


0 -(RootViewController viewWillAppear:) 


Local 




self = (RootViewController *) 0x4d42940 
^ UlTableViewController = (UITableViewController) 

► drinks— ■ ( 一 NSCFArray *) 0x4d4af20 41 objects 

► addButton. = (UIBarButtonltem *) 0x4d48c00 
_cmd = (struct objc_selector *) 0x6d81a2 
animated = (BOOL) YES 

objc_super = (struct _objc_super) {•••} 

l/Ve V^avc ^1 objc^*b dv-*mk 

3V"V*3y k\oy/| ouV" dv ■… k, 

so Y/cVc addm^ rb -to dvmk 


av-v-ay 


All Output i Clear [] || 

General Public License, and you are^ 
welcome to change it and/or distribute copies 
of it under certain conditions. 

Type "show copying" to see the conditions. 
There is absolutely no warranty for GDB. 

Type "show warranty 11 for details. 

This GDB was configured as M x86_64-apple- 
darwin".sharedlibrary apply-load-rules all 
Attaching to process 54393. 

Pending breakpoint 1 - 
11 "RootViewCont roller.m" : 33" resolved 
Current language: auto; currently objective- 
c 

2011-03-05 09:36:11.167 DrinkMixer[54393:207] 
Add button pressed. 

2011-03-05 09:36:11.194 DrinkMixer[54393:207] 
Registering for keyboard events... 

2011-03-05 09:36:14.565 DrinkMixer 【 54393:207] 
Received UIKeyboardDidShowNotification 
2011-03-05 09:36:14.566 DrinkMixer(54393:207] 
Resizing smaller for keyboard 
2011-03-05 09:36:22.318 DrinkMixej ： £54393:207] 
Save pressed! 


El 


V ou b> see i\\t m catK 叔七 i ⑽ a^u ⑽七 his do 瞻扣 d m 七 he d 。 竹 sole: 

p (char*) [[ [self .drinks ob j ectAt Index: 0 ] ob j ectForKey: @ "name" ] UTF8Strmg] 


What did you find? The array 'm'rbidlly has 午 O did*tior\aries m i*ti ddd'm^ our dv-rnkj ； i*t 

has ohC move. |-f we use dohsolc dominndhdi ； we s*tcp *thv-oujh dhd see i^s \rijlvt- 
What’s going on? The *tablcvicw isr/ 七 up 七 he dvmk. Bddcd rb *to dv-'mk arv-ay, 

bu 七 i*t’s no 七 added *to *the dd*bual view. |*t’s like -the -bdble view doesn't know i*t’s … 
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saving, editing, and sorting data 



The Case of the Missing Reservations 
Solved 

Why zvould Nicole ignore such an important nezv 
guest? 

Nicole hasn’t needed to look at the VIP list in 
years. She was so concerned that their important 
customers feel welcome that she didn’t want to 
have to do something as crass as go back and read 
a list every time someone arrived. She made a 
point of memorizing that list so when they came to 
the restaurant she could recognize and seat them 
immediately. As far as Nicole knew, there were 10 VIPs on that list 
and she knew them all. 

The problem was that the list was changed and no one told her. All 
it would have taken was a simple “heads up” to Nicole that there 
was a change to the list and the restaurant’s newest investor wouldn’t 
have disappeared...along with his money. 
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table view data changes 

The table view doesn't know its 
data has changed 

The table view does a number of things to improve 
performance as much as possible. As a result, if you just 



reload its data 

Since we’re modifying the underlying data used by the datasource, 
the easiest way to refresh the table is to ask it to reload its data. 

You do this by sending it the reloadData message. This tells the 
tableview to reconstruct everything — how many sections it thinks it 
has, the headers and footers of those sections, its data rows, etc. 



RootViewController.m 
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saving, editing, and sorting data 




TesT DriVq 


Update your RootViewController.m to tell the table view to 
refresh its data before the tableview is shown, and let’s try 
adding a new drink again. 


Add "this 匕 

youm app. 


l^ecf^HecicIecf Sc^ooJ Girl 


Cdhddi^h whiskey 
sodd 


Add the whiskey, -the soda h> a 
sho*t glass ahd d\rihk. 
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saving works! 




Tqst DriVQ 


To properly test the app now, click the Add button and enter the data for the new drink in the detail 
view. When you’re finished, click Save. 

Now, what happens back in the list view? 





Sav/C 



TWe it is •“ 
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saving, editing, and sorting data 


tJiereiare no ^ 

Dumb Questi9ns 


Telling the table to reload all its 
data seems pretty drastic. Is that really 
how I should do it? 

It’s the simplest way to refresh the 
table data, but not necessarily the most 
efficient. It depends on what you’re doing to 
the table. If you’re modifying the table while 
it’s visible, you can call beginUpdates and 
endUpdates to tell it you're about to make 
a number of changes and it will animate 
those changes for you and let you avoid a 
reloadData call. There are also versions 
that only reload the specified rows or for a 
given section. Which you use depends on 
your application, how much you know about 
what changed in your data, and how big your 
dataset is. 

We didn’t add any code to the 
cancel button. Don’t we have to do 
something there? 


Nope—the cancel button is coded to 
just dismiss the AddDrinkViewController. 

This will clean up any memory associated 
with the controller and throw away any data 
the user entered in the fields. As long as 
we don’t manipulate the drink array, we’ve 
properly canceled any action the user 
started. 

Why can’t I see the drink 
information in the debugger when I 
expand the drinks array and dictionaries? 

This is one of the disadvantages of 
using a generic class like NSMutable 
Dictionary for storing our drinks. The 
debugger knows the class is a dictionary, 
but that’s about all it can tell us, since all 
the keys and values are dynamic. You can 
get to them through the debugging console, 
but that’s not as convenient as seeing 
real attributes on classes when you debug 
something. 


Did we really need to use the 
debugger back there? Couldn’t I have just 
printed out how many items were in the 
array using NSLog? 

Sure, but then you wouldn’t have been 
able to practice debugging again 

Why can’t we use the po command 
for the GDB debugger to see the names 
in the dictionary? 

You can use po [[self.drinks objectAt 
lndex:0] objectForKey:@’’name”] and 
simplify the command we used earlier. The 
catch is that sometimes Xcode has trouble 
figuring out which object you want, so use 
the command from earlier if that happens. 



Uhh—that drink is 
at the end of the list, 
not in with the Rs. 





Look back at your debugging work. Why is the 
drink showing up at the bottom of the table? What 
do we need to do? 
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sorting arrays 


The array is out of order, too 

Our table view gets its information directly from our drink array. 
In fact, we just map the row number into an index in our array 
in cellForRowAtlndexPath:. 


value U ^ a„a 7 . So v-o^l^ ^ 
be >wV>a*bcvcv- >wc V^avc m s-t s^o » 

a\rva7-v>awcl7, ou\r yvow d^mk. 



RootViewController.m 


Sort your array using NSSortPcscriptor 

In order to get the table view properly sorted, we need to sort our data 
array. NSSortDescriptors can do exactly that. You tell descriptors what 
to compare by specifying a property, how to compare them with an 
optional selector, and then which order to display the information in. 
In our case, we’re looking for alphabetical sorting by the name of the 
drink. 


>/ 扣 七七 he 

NSSovtPcsdv'iftov 
*to sov 七 based oy \ 
dvmk 


// Sort the array since we just added a new drink 

NSSortDescriptor *nameSorter = [[NSSortDescriptor alloc] 
initWithKey:NAME— KEY ascending : YES selector : @selector(caselnsensitiveCom 
pare:) ] ; 

[drinkArray_ sortUsingDescriptors : [NSArray 
arrayWithObject:nameSorter]]; 

[nameSorter release]; 

To do sort simfly ask a^ay 
{jo sori itself ^ ouv stkcW 


l-f ^ovidc a scIcdW, \i dots a 

tasc-sc^s'itWc tomfav-'ison, but wc wad a 

tasc-*mscr\si*tWc or\C. 


Add this \v\ -the save rweihod a-Picv- you add -the ^ 
da*t3 "to the avray bu*t bc-Po\rc "the viev/ gets popped 
o(( 七 he s-tatk. 


AddDrinkViewController.m 
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saving, editing, and sorting data 



Tesr DriVq 





6o6Wta、l # ass a 以 


straw 


SV^akc ㈣ 如， 


Add the sorting code to AddDrinkViewController, then 
run the app. Let’s add another drink; this one should 
end up in the right place. 




Great, that new drink is 
there, but what about the Red- 
Headed School Girl from before? 

Don*t we need to deal with saving more 
permanently? 

All our data is lost when we quit... 

We’re positive we’re updating the array with our 
new drink, but obviously that new array doesn’t 
survive quitting and restarting our app. 

What do we need to do? When should it happen? 
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when to save 



Jim: OK, so we should save the array after each new drink is 
added, right? That will make sure we always have the right data. 

Frank: Not so fast. Keep in mind the whole speed/memory 
management thing. 

Joe: What’s the problem? It’s just a little array. 

Frank: But that means you could be saving every time you add a 
drink. 

Jim: Oh, I see, that means we’ll have to go through reading in the 
array and saving it back out multiple times. That does seem like a 
waste. 

Joe: Well then, when are we supposed to do it? 

Frank: When we background the app! With multitasking, apps 
don’t really close anymore, but when it goes to background, we can 
save it. 

Jim: How do we do that? How can we tell when the user 
backgrounds the app? 

Frank: Hmm...what about that applicationDidEnterBackground 
method on our app delegate? 

Joe: But the app delegate doesn’t know anything about our drink 
list or where to save it... 


Frank: Good point. The UIApplicationDelegate says there’s a 
notification that goes out, too. I bet we could use that... 


thereicO'e no ^ 

Dumb Questions 


What notification tells us the 
application is going into the background? 

The iOS will send out an 
UlApplicationDidEnterBackground when your 
app is put in the background. Since iOS 4, 
iPhone supports multitasking, so they can 
do limited tasks in the background, but in 
general, they suspend shortly after entering 
the background state. 

Do I need to register to receive it? 


Yup—just like any other notification. 

What if the user hits the home 
button or the phone rings or...? 

In general, if the user answers the 
phone, views a text message, or does 
something else to trigger the iPhone or 
iPad to switch applications, you'll get the 
applicationDidEnterBackgournd. There’s 
really only one case where you won’t … 


What happens if my app crashes? 

Then you’re not going to get the 
notification. The data would be lost in this 
case. You need to balance how critical 
it is to make sure no data is lost with 
the performance impact of saving more 
frequently. In our case, we’re just going 
to save on background. In general, Apple 
advises you to save as close to the user 
interaction as possible—we’ll build an app 
that behaves that way later in the book. 
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saving, editing, and sorting data 


i^terpen your pencil 


o 


❺ 


Use Jim, Frank, and Joe’s discussion and your skills at 
working with the API to figure out what to implement 
to save the array. Update RootViewController.m and 
RootViewController.h to handle saving. 


Add the code to save out the new plist of dictionaries. 

Implement the method that will be called when the UIApplicationDidEnterBackground 
Notification is sent to save the plist. We’re going to give you a little code snippet to use. This 
code will only work on the simulator, but we’ll revisit this issue in a later chapter. 

NSString *path = [[NSBundle mainBundle] 

pathForResource : @"DrinksDirections" ofType : @"plist"]; 

[self.drinks writeToFile : path atomically : YES]; 

Register for the UIApplicationDidEnterBackgroundNotification. 

We know that the applicationDidEnterBackground: method will be called on the 
AppDelegate when the application is sent to the background, but our RootViewGontroller 
really owns all of the data. Have the RootViewG ontroller register for the UIApplication 
DidEnterBackgroundNotifcation just like the AddDrinkViewGontroller did, except add the 
registration and unregistration code to viewDidLoad and viewDidUnload, respectively. 



This code will only work in the simulator! 

The code used to save the plist will work fine on the simulator, but fail 
miserably on a real device. The problem is with file permissions and where 
apps are allowed to store data. We’ll talk a lot more about this in Chapter 8, 
but for now, go ahead with this version. This is a perfect example of things 
working on the simulator but behaving differently on a real device. 


Watch it! 
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sharpen solution 


^Sharpen your pencil 

Solution 


Use Jim, Frank, and Joe’s discussion and your skills at 
working with the API to figure out what to implement 
to save the array. Update RootViewController.m and 
RootViewController.h to handle saving. 


Add "this *to vicy/DidLoad. 


RootViewController.m 


// Register for application backgrounding so we can save data 

[[NSNotificationCenter defaultCenter] addObserver : self 

selector : ©selector(applicationDidEnterBackground:) 

name : UIApplicationDidEnterBackgroundNotification object:nil]; 


"this \y\ Roo'tViewCojrrbrolldm. 


(void)applicationDidEnterBackground : (NSNotification *)notification 


NSString *path = [[NSBundle mainBundle] 

pathForResource : @"DrinksDirections" ofType : @"plist 
[self.drinks writeToFile : path atomically : YES]; 


rr 


Add this *to vicy/DidU^load. 


n*is IS i\\t Code tWs jomj -to jWc us Problems on 
^edl dcvitc. Well*m*to tWis aja'm Ca^d ^ m 


乩 after — bear W\i\\ us W now.... 
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saving, editing, and sorting data 



TesT DriVq 





p ⑽ pp/ e 


Pout I. 

" ih : 1 : 


fil, 

^ 9^pe. 


tteve •， 七 ， s ! 


Make suv-c >n\\cv\ you v-ur\ 
P/mkMi%c\r b\t second time you 
*bap oy \ *bV^C *idor\ m *tV^C simulatov -； 
dcm，*b Wrt Build artd Pcbu^ aja'm! 



/Wthoir s ho-tc ： wc thought about sWma £he 
sa ” s ^^oi twi^ but ^iguved that st.|| 
:ouldh 七 pirovc that it saves a-Ptcv hiUiha 
the home key ahd ^ihj bad m. 


Stopping and hitting “Build and Debug” in Xcode is NOT the same as 
pushing the Home key and relaunching the app in the simulator! 


When you stop the app using Xcode’s Stop button, you are killing the app right then 
and there. No termination notifications are sent, no saving is done — it’s just stopped. 
Likewise, when you click Build and Debug, Xcode will reinstall the application on 
your device before launching it To test our load and save code, make sure you restart the app by 
tapping the icon in the simulator. 
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no dumb questions 


t^ereiare no o 

Dumb Questi9ns 


So arrays know how to save 
themselves...Can I just put any object in 
there and have it save to a plist? 

No—not just any old object. Arrays 
load and save using a Cocoa technique 
called NSCoding. Any objects you want 
to load and save must conform to the 
NSCoding protocol, which includes 
initWithCoder and encodeWithCoder 
method—basically, load and save. You’d 
need to conform to the NSCoding protocol 
and provide those methods to so that objects 
can be archived and distributed. However, 
NSDictionaries do conform to NSCoding (as 
do the strings inside of them), and that’s why 
we can load and save so easily. 

Q/ What is the deal with giving us 
code that won’t work on the device? What 
happens? 

Well, to find out what happens, we 
encourage you to run it on a real device. 
Then think about why it isn’t working the way 
you’d expect. We’ll talk a lot more about 
this in the next app. To give you a hint, it 
has to with where we’re trying to save the 
data. This is also a real-world example of 
something working just fine in the simulator 
only to behave differently on a real device. 
You always need to test on both. 

Instead of registering for that 
backgrounding notification, couldn’t 


we have just updated the AppDelegate 
to get the drink array from the 
RootViewController and save it in the 
delegate? 

Yes, you could. It’s more of a style and 
design question than anything else. Right 
now, the AppDelegate doesn’t know anything 
about our plist, our drink array, or even the 
RootViewController, for that matter (other 
than making it visible). You could argue we’d 
be breaking encapsulation if we exposed 
what needs to be loaded and saved for each 
view up to the AppDelegate. Since we only 
need to save a single array, it’s not a big 
deal either way, but if you have a number 
of views that need to save information or 
complex persistence code, it’s often cleaner 
to leave it with the class that needs to know 
about it rather than lumping it all into the 
AppDelegate. Technically speaking, though, 
either one would work. 

Why did we register and unregister 
in the viewDidLoad and viewDidUnload 
methods instead of the *Appear 
methods? 

The problem is when and how often 
those methods are called. viewWillAppear 
is called whenever the view is about to be 
shown. That starts out OK—we'll get that call 
before the table view shows up and we can 
register. However, the viewWillDisappear 
will be called right before we show the detail 
or add drink view controllers (since our 
RootViewController is about to be hidden). 


If we unregister there, we won’t get the 
backgrounding notification if the user 
decides to quit while looking at the details 
for a drink. 

For example, say the user adds a new 
drink, goes back to the RootViewController, 
then taps on his drink to make sure he 
entered it correctly. We show the detailed 
view, he’s happy, then he quits the app. Our 
RootViewController has unregistered for the 
backgrounding notification and the drink is 
lost. Instead, we use the load and unload 
methods, which are called when the view is 
loaded from the nib or unloaded. Since that 
view is in use throughout the application, 
those won’t be called except at startup and 
shutdown. 

What’s the deal with hitting “Build 
and Run” versus tapping on the icon to 
start DrinkMixer the second time? 

It’s because of how we're saving the 
data. We’ll talk more about it in the next 
chapter, but the problem is when you hit 
“Build and Debug,” Xcode compiles and 
installs the application onto the simulator. 
This means it’s replacing the modified drink 
plist with the one that we ship with the 
application and you lose your drink. Which, 
everyone can agree, is very, very sad. 
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saving, editing, and sorting data 



Thafs great! Now I can add the extra 
drinks I need. But there are a couple of 
other things that I need to really make this 
app work for me. Think you can help? 






How can we implement these things? Where 
in the app do we need to handle this stuff? 
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table views support editing 


Table views have built-m support for 
editing and deleting 

Good news! The table view comes complete with almost everything we 
need for deleting data. This is behavior that acts a bit like implementing a 
Save or Cancel button, and a lot of it comes preloaded. 


Editing mode adds an Edit button to the Navigation Control in the main 
view, and when it’s pressed, indicators appear to the left of the table cell 



that can be selected and deleted like this 


TW,s UtU ^11 vead 

仏 e delete^ . 




14 


PM 




Carrier 


Drink 


Cone 


Lemon 


Drop 



dv-mks array will be 
modified needed 3*(""tcv* 
■tiic dv"»y\ks avc deleted- 







TV>c edvt WtU ' 如 

W ⑽ 一 to 

如 edvt— 州 0 dc . 



The delete (ouv v\cv/ 
to^broWtr) V^a^lc 
mode table is rn a^d 
\\av\d\t dclct»^ dv-'^ks. 
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EDITING VIEW CONSTRUCTION 


Using the view below, write what each part of the editing view does. 



Drink Mixer 


Done 


e 


Lemon 


Drop 


O 


Letter 


Bomb 
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editing view construction solution 


EDITING VIEW CONSTRUCTION SOLUTION 

Using the view below, write what each part of the editing view does. 


The Vov\t bu*t*bo^ *tu\rhS 
o^f editm^ mode 
puis {ht -table badk bo 

hOV"inr\3|. 


The delete \Coy\s Irt -the 
user ddrle d vow -fvom 
*tKc table. 



3 




2:14 


PM 


Drink Mixer 


Done 


e ； Lemon Drop 


O Letter Bomb 



The + bu*t*bo^ is 

i*t lets us add 
d hew dbrmk. 


W\\cy\ ^ 

•m cdi*t mode, we should 
be able *to edi*b 3 dv-'mk 


ms*tcad jus*t displaym^ 


it- 
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saving, editing, and sorting data 



苢 ExeRciSe 


o 

o 

o 

o 

o 


The Xcode template we chose for this app comes with a good bit of the code well need, 
and at this point, you’re pretty familiar with the RootViewController and the table view. 
We’ll give you some hints on what to implement next, but let you take it from here. 


Add the Edit button to the root view. 

We need an Edit button in the upper left of the navigation bar. The templated code 
for the UITableViewGontroller comes with everything we need built-in; it’s just a 
matter of uncommenting the line in viewDidLoad. 

Implement tableView ： commitEditingStyle ： forRowAtIndexPath. 

Once the table view is in editing mode, we’ll get a call when the user tries to delete 
a row either by swiping across the row or tapping the delete indicator. Most of 
this method is stubbed out for us too, but you’ll need to add code to update the 
datasource with the change. Remember, we’ve been mapping rows to indexes in our 
array. Finally, you don’t need to call reloadData after this change because we ask the 
table View to explicitly remove the row. 

Update the didSelectRowAtlndexPath to add a drink. 

Our AddDrinkViewGontroller has nearly everything we need to be able 
to edit an existing drink. Update didSelectRowAtlndexPath to invoke the 
AddDrinkViewG ontroller instead of the DririkDetailViewController if weVe in 




Make sure Interface Builder knows its editable. 

Verify that “Allow Selection While Editing” is checked for the Drinks table view. 


Add the ability to edit a drink in our AddDrinkViewController. 

You’ll need to tell the app that it must edit a drink instead of creating a new one, then 
have it populate the controls with the existing information, and finally update the 
drink on save. 


o 

o 

o 

o 

o 
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exercise solution 



Exe^ctSe 
SoLytioH 


The Xcode template comes with a good bit of the code we’ll need, and at this point you’re 
pretty familiar with the RootViewController and the table view. We’ll give you some hints 
on what to implement next, but let you take it from here. 



Add the Edit button to the root view. 

We need an Edit button in the upper left of the navigation bar. The 
templated code for the UITableViewGontroller comes with everything we 


need built-in; it’s just a matter of uncommenting the line in viewDidLoad. 


I 灼 vicv/DidLoad 



RootViewController.m 


Q Implement the tableView ： commitEditingStyle ： forRowAtIndexPath. 

Once the table view is in editing mode, we’ll get a call when the user tries to delete a row either by 
swiping across the row or tapping the delete indicator. Most of this method is stubbed out for us 
too, but you’ll need to add code to update the datasource with the change. Remember, we’ve been 
mapping rows to indexes in our array. Finally, you don’t need to call reloadData after this change 
because we ask the table View to explicitly remove the row. 


// Override to support editing the table view. 

- (void)tableView:(UITableView *)tableView commitEditingStyle:(UITableViewCellEdi 
tingStyle)editingStyle forRowAtlndexPath:(NSIndexPath *)indexPath { 

if (editingStyle == UITableViewCellEditingStyleDelete) { j|X sc y-cr^ovcObjcd*tA*tl^dc% *fco 
// Delete the row from the data source. r tlcav> uf ouv daiasouv-dC- 

[self•drinks removeObjectAtlndex : indexPath.row]; 

[tableView deleteRowsAtlndexPaths: [NSArray arrayWithObj ect : indexPath] 
withRowAnimation : UITableViewRowAnimationFade]; 


if (editingStyle 


UITableViewCellEditingStyleInsert) 


RootViewController.m 
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saving, editing, and sorting data 


o Update the didSelectRowAtlndexPath to add a drink. 

Our AddDrinkViewGontroller has nearly everything we need to be able to edit an existing 
drink. Update didSelectRowAtlndexPath to invoke the AddDrinkVie wG ontroller instead 
of the DrinkDetailViewGontroller if we’re in editing mode. 


// Override to support row selection in the 

table view. 

- (void)tableView:(UITableView *)tableView didSelectRowAtlndexPath:(NSIndexPath *) 
indexPath { 

if (!self.editing) { 

DrinkDetailViewController ^drinkDetailViewController = 

[[DrinkDetailViewController alloc] initWithNibName:@"DrinkDetailViewController 〃 
bundle : nil]; 

drinkDetailViewController.drink = [self.drinks objectAtlndex:indexPath•row]; 

[self.navigationController pushViewController : drinkDetailViewController 

animated:YES]; 1 Fi^si we rsttd bo dhetk bo see \( 

y/C vc *m mode- l-r Y\ot) just 

else { display v>o\rrwal dc*tail vic>w- 

AddDrinkViewController *editingDrinkVC = [[AddDrinkViewController 
alloc] initWithNibName : @^DrinkDetailViewController^ bundle : nil]; 

editingDrinkVC.drink = [self.drinks obj ectAtlndex : indexPath.row]; 
editingDrinkVC.drinkArray = self.drinks; 

UINavigationController *editingNavCon = [[UINavigationController 
alloc] initWithRootViewControiler : editingDrinkVC]; 

[self.navigationController presentModalViewController : editingNavCon 
animated:YES]; 

[editingDrinkVC release]; 

[editingNavCon release]; 


|-f y/c av*c m mode, dvea 七 e 扣 

AddP^mk\/^>wCoy>*tvollcv ar\A Sti dv-*mk *to 
td\i addition -to ouv dhrmk a\r\ray. We'll -f ix. 
uf /\ddDv* … kViO/Cowbrollev* m a … 




RootViewController.m 


Just tire ActctDrink ViewController left … 


you are here ► 305 









exercise solution 



Exe^ctSe 
SoLytioH 


o 


The Xcode template comes with a good bit of the code we’ll need, and at this point you’re pretty 
familiar with the RootViewController and the table view. We’ll give you some hints on what to 
implement next, but let you take it from here. 

Make sure Interface Builder knows its editable. 

Verify that “Allow Selection While Editing” is checked for the Drinks table 
view. 


« o o 




ii R ® A 



DfinkMixcr 

- 1 Urgd. lUb 

r Oavvcs 

^ fUKKV)«wConiroller.h 
m ftAOTViriMC ontroller m 
H OvinkMixcrAp(iOcl«gate.h 
m OrinkMix«fApp€>€l«gate.m 
h nrmkDetailV^wC AntralIrr.h 
m OrinkDvUilViewConUolkr.r 
III OrinkCon&unu.h 
h Addl>nnkVieM.ofltfOlkr.h 
m AddOvinkV*e%i<gfilroll«f.r 
_ Oftitr Soorcts 

h OrinkMixcr_Prchx.pch 
m mjin.vn 
— Resources 

UrinkDtrections.plist 

OrinkD«ta«IVkwCootrolkr.x>b 


MatnWirvdow.xib 
(VinkMixer-Info.plitt 
DrinkArrjy.plisi 
Frameworks 
(JtKit frAmrwocic 
ft roundAtion.fnmewofV 
LorcCraphics.framewofk 
^ Producti 
OvinkMij 
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saving, editing, and sorting data 



Add the ability to edit a drink in our AddDrinkViewController. 

You’ll need to tell it that it must edit a drink instead of creating a new one, then have it 
populate the controls with the existing information, and finally update the drink on save. 


-( 工 BAction) save : (id) sender { 
NSLog (@’’Save pressed !’’）； 

if (self.drink != nil) { 


|-f 七 Vive’s a dv-*mk sc*t, *thcir> >wc *to ufda*tc *i*t- 1/Vc 
da 竹 cithcv- uf date -the objcd*t ov vcpladc it Smde 

y/c y\tt& *to v*c—sov*t "tKc >wV>olc 3v*v3y 扣丫如巧 (•… 
dvmk CMaY\(\t<0, >wc \us-t v-emove -the old OY\t av\d v-c- 

add it 

// We A re working with an existing drink, so let's remove 
// it from the array to get ready for a new one 
[drinkArray_ removeObject : self.drink]; 

self.drink = nil; // This will release our reference too 


// Now create a new drink dictionary for the new values 
NSMutableDietionary* newDrink = [[NSMutableDictionary alloc] init]; 


AddDrinkViewController.m 
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ifs all in there 




TesT DriVq 


Try removing or editing drinks now. You should be able to remove drinks and 
fine-tune them all you want. Remember to restart your app by tapping on the 
icon, though; otherwise, you'll lose your changes. 



Resutmit your app 


to tke store anct. 


參# 
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saving, editing, and sorting data 







J3 Miisic 
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Y 

GE> 
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O 

離 ftooks 

o 

jj&L Riffljlonts 


ftjdiu 



$ knwjs 
:5 Gcfiiul 

^ IVp Cm THp Wnrtft On A U 
RimblinT Man 

^ sanu Wanlea 

PLAYLISTS 
g- ITim#^ Of 


AJ' 


i' <1 !i«arch Store 


^ furLhJtiKl 


=t» purrhi^fil 
if eurch* 5 ta 


D Furthjiitil 


DtVICtS 

SHARED 
rg 11^ Viutt 


Ermm^mw 


QeiiiA uamfi... 


^m nhaRi>. ■ 呻桃邮阳 
fpiyi.TjgWT>!MH da/MS 


AUfclMliAA Op*n 


f-firPifft »n-t 

GafMS 


Samos 

4. Cut iher Hops 


Here’s DrinkMixer at #i\ 
Congratulations! 
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na viga tion con troller cross 



NavigationController cross 

Let’s check your scroll view, nav control, and table 
view buzz words! 



Across 

1. A field that the user can change is_ 

2. Arrays load and save using_. 

5. System-level events that can be passed are called 


6. Sort data using the_. 

7. All the sytem events go through the_ 

center. 

8. The scroll view won't work without setting the 


9. viewWillAppear and_are called at different 

times. 


Down 

1. Table views have built-in support for_. 

3. Keyboard events tell you about the_and size of 

the keyboard. 

4. The_handles the scroll bar, panning, 

zooming, and what content is displayed in the view. 
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saving, editing, and sorting data 


tJiereiare no ^ 

Dumb Questi9ns 


I like the automatic editing support 
in the table view, but how do I do those 
cool “Add New Address” rows that the 
iPhone has when you edit a contact? 

It’s a lot easier than you think. 

Basically, when you’re in editing mode, you 
tell the table view you have one more row 
than you actually have in your data. Then, in 
cellForRowAtlndexPath, check to see if the 
row the table view is asking for is one past 
the end. If it is, return a cell that says “Add 
New Address” or whatever. Finally, in your 
didSelectRowAtlndexPath, check to see if 
the selected row is one past your data, and if 
so, you know it was the selected row. 

We haven’t talked about moving 
rows around, but I’ve seen tables do that. 
Is it hard? 

No, the table view part is really easy; 
it’s the datasource part that can be tricky. If 
you support moving rows around, simply 
implement the method tableView:move 
RowAtlndexPath:tolndexPath: (the tableview 
checks to see if you provide this method 
before allowing the user to rearrange 
cells). The users will see a row handle on 
the side of the cells when they’re in editing 
mode. When they move a row, you'll get 
a call to your new method that provides 
the IndexPath the row started at and the 
IndexPath for the new position. It’s your job 
to update your datasource to make sure 
they stay that way. You can also implement 
tableview:canMoveRowAtlndexPath to 
only allow the users to move certain rows. 
There are even finer-grained controls in 


the delegate if you’re interested, such as 
preventing the users from moving a cell to a 
certain section. 

What if I don’t want the users to be 
able to delete a row? Can I still support 
editing for some of the rows? 

Absolutely. Just implement tableview: 
canEditRowAtlndexPath: and return NO for 
the rows you don’t want to be editable. 

When we edit a drink, we replace 
the object in the array. What if we had 
some other view that had a reference to 
the original? 

Great question. The short answer is 
you’re going to have a problem, no matter 
how you handle it. If some other view has a 
reference to the object we removed, that’s 
not tragic since the retain count should 
still be at least 1 : the object won’t get 
deallocated when we remove it. However, 
the other views obviously won’t see any 
of the changes the user made since we’re 
putting them in a new dictionary. Even if they 
had the old dictionary, they wouldn't have 
any way of knowing the values changed. 
There are a few ways you could handle 
this. One option is you could change our 
code to leave the original object in the array 
and modify it in place, then make sure that 
any other view you have refreshes itself on 
viewWillAppear or something along those 
lines. Another option is you could send out 
a custom notification that the drink array 
changed or that a particular drink was 
modified. Interested views can register to 
receive that notification. 


Aren’t we supposed to be 
concerned about efficiency? Isn’t 
removing the drink and reading it 
inefficient? 

It’s not the most efficient way since 
it requires finding the object in the array 
and removing it before reinserting it, but for 
the sake of code clarity, we decided it was 
simpler to show. We’d have to re-sort the 
array regardless of which approach we took, 
however, since the name of the drink (and 
its place alphabetically) could change with 
the edit. 

We added the edit button on the 
left-hand side of the detail view, but what 
about a back button? Isn’t that where 
they usually go? 

That’s true. When you get into having 
an add button, an edit button, and a back 
button, you run into a real estate problem. 
The way we solved it was fine, but you’ll 
need to make sure that your app flows the 
way you need it to when your Navigation 
Controller starts to get crowded. 

We still have some oddities like 
the drink being editable in the detail view. 
Should we worry about that? 

Yes. So much of what has made iOS 
and the app store successful is the polish 
that Apple and iOS developers have put on 
their applications. It’s the difference between 
a pretty good app and a chart-topping, wow- 
inducing success purchased by hundreds of 
thousands of users. 
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na viga tioncon troller cross solution 



Navi^ationControllep cross 
Solution 


Let’s check your scroll view, nav control, and table view 
buzz words! 



Across 

1. A field that the user can change is_. 

[EDITABLE] 

2. Arrays load and save using_. [NSCODING] 

5. System-level events that can be passed are called 
_■ [NOTIFICATIONS] 

6. Sort data using the_. 

[NSSORTDESCRIPTOR] 

7. All the sytem events go through the_ 

center. [DEFAULT] 

8. The scroll view won't work without setting the 
_. [CONTENTSIZE] 

9. viewWillAppear and_are called at different 

times. [VIEWDIDLOAD] 


Down 

1. Table views have built-in support for_. 

[EDITING] 

3. Keyboard events tell you about the_and size of 

the keyboard. [STATE] 

4. The_handles the scroll bar, panning, 

zooming, and what content is displayed in the view. 
[SCROLLVIEW] 
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saving, editing, and sorting data 



Your iOS Pevelopment Toolbox 

You’ve got Chapter 6 under your belt and 
now you’ve added saving, editing, and 
sorting data to your toolbox. 


Scroll \/icw 

like d IchS -fco show ohly *thc 
part the view you heed av\d 
scrolls 七 he \rcs*t o^f -the sdv-cch. 

Meeds *to be jivch 3 doh*tch*tSizjC 
b> work p\ropc\rly. 

Cah be easily dohS-trud-ted ih 
|h*tc\rfadc Builder 

No 七 A 乙 a 七 

f\yr t system-level events you 

da 於 a^a use *rn your 

The default 

handles most y\oti-f*i6a*t»or\S. 

PiWcrc^-t ^amev/orks use 
diWcv-c^ ^ot»^ or you dair. 

dreate Y our ovm . 




私 iA?w Ec /洋. 

Thc c dii buH 




ihc 
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Sam's new idea 


Sam has another project in mind... 



Congrats 

on the app. So, we all 
just got iPads as a bonus. I bet 
DrinkMixer would look awesome on 
mine! 
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7 migrating t9 iPad 




^ We need more room ♦ 

% 



« 


I need a device thats more like 
a book. Does Apple have one of 
those? 


Ik : 麵 :' 






fe 






iPhones are great, but a bigger screen can be better. 

When the iPad first launched, some panned it by saying that it was “just a big iPhone” (but 
uh, without the phone). In many ways it is, but that screen opens up many opportunities 
for better user interaction. More screen real estate means that reading is comfortable, 
web pages are easily viewed, and the device can act more like a book. Or a calendar. Or 
many other things that you already know how to use, like a menu... 


this is a new chapter 
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drinking big 


PriwkMixcr ow the iPad 


It happens all the time: a new device comes out and now your clients want to use it. 
iPad and iPhone apps have lots of overlap. iOS runs both devices, which are touch 
screen-based, and only one app is allowed to be visible at a time to users. 

The big difference? The screen size! 


,pad be used m 



Lots of W 
av-c - f ^ 


s 




The iPhone 

is o^ly i ^ 

dia^ally- 



TV^c »Pad 


sCrttv\ 

(i\a^ov>all 7 ' 


\s °ir 



TV »Pad s 伙 cc 饩 
v-csolutioy\ is ^ 1 02 -^- 


iPhones have 
dlaia attess 
mos*t 

The iPW 今 (… 狀 七 , 

Re 七 ma displaY) has a 

v-csolu*biov> ^0 

和 0. 
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migrating to iPad 



O 


o 


Let's just run DrinkMixer 
on the iPad. iPhone apps are 
supposed to work too, right? 


Yes, they do. 

Every iPhone app on the App Store 
will run on iPads right out of the 
box, but there’s a catch. 



this! 


Open up DrinkMixer in Xcode and run it in the iPad 
simulator. Then you can see what we’re dealing with. 




Click 

hcirc dhd 

iPad 

Simula*to\r. 



x«r 


tOS Device 
iPad 4.2 Simulator 
V iPhone 4.2 Simulator 


Edit Schem«.._ 
N«w Schem«... 
DrinkMj Manage Schem€S. 




DrinkMixrr ftaotVic^MCantrallrr.h 

Runninti DtinKM<xer iPhufif SimuUlo* 

Na !%%<!#• 

OMb] raFTa'J 

’ UnnkMix^f 

C h] RaocVi^M ontroilf-r.h No S#l#<tion 



i rijuf % 
JliL^ 


m KoutV^TMiCufUrulkr^fn 
|h_i DrinkMivrrApptVtrgare h 
m OnnkMixtrAppOekgitt.m 
h OrinkOcUifViewConUolkf.h 
m OftnkOfiaifVi^wronrrollrr m 
fh] OnnkConstamu.h 
|h_' AddDrinkVi«^iiCvntrtfllcr t h 
m AddDri nkVtcwComrolkf. m 

一 Ottlff SAUfffi 

_ Resources 

- Frjmcwvrks 
Produm 


it 


^«rOtVicwControl\cr«h 

Orlnktllxcr 

Crrntrd by Oah Pllonr on ll/>A/lft. 
Copyright f\r-®rnt ft 4 f Ilf. At 


•import ^tlllUt/UlKit.r» 

rinterf®ce RootVxe^ontroller : UlT«bleViewC<Kttrolle 
NSHiit«bleArray ^dri^ks.; 

UIBdrBullonlirT •jdd8utlon_; 

> 



Build and run... 
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big, but ugly 


The iPad simulator 


The simulator will launch the iPad with the DrinkMixer iPhone app, as is. You didn’t 
have to change a line of code, and it does work. Of course, the simulator is enough to 
show you that just running the iPhone app on the iPad isn’t ideal. 

First off, it’s the size of an iPhone app, but on an iPad. Ugh. You can change the 
size of the view to fill the entire screen by “doubling” the pixels, but that doesn’t 
change the resolution of the view, so the graphics don’t look as good. Play with it in the 
simulator, too, and we’ll bet it doesn’t really feel right, either... 


飯的 u— ㈣ 如十 ㈣ 

七 he a 代 looks Y\oi oy^lv 

elated, Wt 
I 七 looks boiaWi out 


Drink Mixer 


After Dinner Mini 
Aftershock 
Apple Martini 
Bak&d Apple 
Bee Stinger 
&ch&Hc Jyice 
Black Eyed Susan 
Blue Dog 

B-oolcm^ker's LucK 


Clidk *bo 

double 
pixels. y 




_ 


er Mint 

> 

I 

- 


> 

: 


> 

> 



> 

dSusan 

> 

I 


okmalw's 


Luck 




Wow. I don’t know how you fix it, but 
that is not what I was thinking an iPad 
version of DrinkMixer would look like... 
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migrating to iPad 


The Hlft covers iPads, too 


Since the device has changed, let’s 
go back to the HIG. If you work 
your way through the iOS Human 
Interface Guidelines, you’ll find a 
section called “For iPad: Restrain 
Your Information Hierarchy.’’ For 
DrinkMixer, that means we need to 
use the extra real estate that comes 
from the big screen to reduce the 
number of screen transitions. 
For example, you can easily display a 
detail view next to a list view using a 
Split View Controller. 

sV^ov/s 

•two levels data, 
M a S 沙七 

Co^-bv-ollcv-. 


Hty MobileAAe Accminl Inbox (44) Edit 
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Although a you d SCreen and iPad -specific Ul elements^ 二 -- 


Hierarchy 


Dor 


»n general, focus the main lo 训 at they Want Wdnr to 阶 v ent 1 

it the large iPad screen. anH m __ 
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tools in an 
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Settings 

Gte/ VPN 
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Picture Frame 
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产 Safari 


Double-click the Horn© Button for: 
Home 

Search 

iPod 

iPod Controls 
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赠 . /払 used ih 
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m-tvodutc a Kicv-avdiiY. 



What are some apps that you’ve used for both iPad and 
iPhone? Are there any elements that are iPad-specific? 
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interview with iPad 



This week’s interview: 

What makes you different? 


Head First ： Hi, iPad! It really exciting to be 
interviewing a famous device like you. 

iPad ： Thank you! I’m happy to be here. There are lots 
of other tablets out there, but once you know me, you 
know the best. 

Head First ： That’s a great lead-in for me. How do 
you answer the critics that say you’re just a big iPhone? 

iPad ： Would that really be such a bad thing? People 
who say that just don’t understand us. We do have 
some things in common, like the touch screen, iOS, 
accelerometers, and awesome apps, but the apps are 
usually different. 

Head First ： Well, your apps are bigger, right? 

iPad ： Yes, but you’re missing the point. My screen is 
bigger, but because of that, you interact with me very 
differently. 

Head First ： How so? People still use the same 
gestures? 

iPad ： When you pick me up, I’m more like a book 
than iPhone. iPhone is more about getting things done 
quickly and moving on. Me, you want to sit down and 
spend some time with. I might even write my own 
book: iPhones Are From Mars, iPads Are From Venus. Don’t 
you agree? 

Head First ： Ummm, that’s probably true. I’ve noticed 
that you move around more, too. 

iPad ： My Apps need to support all four orientations, so 
no matter how you pick me up, it just works. And there 
should be less bouncing around. 

Head First: What? 

iPad ： When you’re using iPhone, the screen is really 
small (but pretty, I wish I had that awesome display). 
Anyway, because the screen is small, you’re going 
between screens a lot on iPhone. With me, designers 


usually put a lot on one screen. They call that 
“restraining the hierarchy.” 

Head First ： Interesting. Do you have any special 
views? 

iPad ： I do. To reduce the number of views, there is a 
Split View Controller just for my apps. In landscape, 
it shows a table view on the left side of the screen and 
the detail view on the other side. So as soon as you pick 
something, you can see the details without hiding the 
list. 

Head First ： Is that what you use for mail? 

iPad ： Yup, it’s perfect for that. And if you shift that 
Split View Controller to portrait, it just shows the detail 
view, until you click on a navigation button and see the 
pop over. 

Head First: The what? 

iPad ： The popover. It’s another one of my own special 
controls. It’s like a dialog box that appears on the 
screen without covering the whole thing up. 

Head First ： Like a speech bubble? 

iPad ： Exactly. Great for little bits of information, color 
settings, stuff like that. 

Head First ： What don’t you have? 

iPad: I’m like an iPod Touch. Limited GPS, sometimes 
no camera. Those are the biggies. 

Head First ： Anything you’d like to add? 

iPad ： Well, people should really take advantage of my 
size. Use visual clues from the real world to help people 
use your app. You have lots of space to work with and 
room for lots of fingers touching things. Think about 
how real books, calendars, switches, dials, and real 
physical controls look and feel. Take advantage of that. 

Head First ： Thanks, iPad. Can’t wait to get started! 


320 Chapter 7 


migrating to iPad 




Sketch up the Ul for the new DrinkMixer iPad app. You’ve got more room, so be sure to use it 
well! Consult the HIG and make sure you know what information is going in which element of the 
view. 






Kcwcwbcv ) 

*tW»s v/V^olc 3^ 

«Pad a 州 

•,Pad wbrol s . 
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exercise solution 



Now we have an idea of the Ul for the new iPad app. Having this all put together first is going to 
help keep everything going in the right place as you code. 




TV>c S 沙七 — Co^broWcr \s a 
vrtibi ?ov/CV-^l tor^brol \i 巧卜 

vcstvamma a^d it looks 

yod t>o, cvcy. m ?0 ^ra • 七州 ode 糾找 

a ^ofovcv-! 
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tKereiare no o 

Dumb Questi9ns 


Is building an app for iPad really 
that different than building for iPhone? 

From a coding and development 
perspective, no, they’re nearly identical. 

But from a design and Ul perspective, yes, 
they’re very different. It's important to spend 
time with an iPad to make sure you “get it.” 
When designing iPad apps, there will be a 
point where an app will just start to feel like 
an iPad app. It’s lots of little design elements 
like the use of space, textures on controls 
and Ul components, interaction patterns, etc. 
iPhone apps are much more about ease of 
use with your thumb, quick access to data, 
etc. iPad apps are “bigger” than that. People 
sit on couches and really soak in iPad apps. 
Give them that kind of depth. 

Does ‘‘restraining the hierarchy” 
just mean using a split-view control? 

No. That’s one way to help get there, 
but it’s definitely not the only way. We’ll 


use a split view control for DrinkMixer, but 
there are lots of other things to consider. 

For example, let’s say you have summary 
information about chapters in a book. In 
an iPhone app, you might have a table 
view listing the chapters, and tapping on a 
chapter will show that summary information. 
In an iPad app, you might want to have a 
fancy table of contents only showing three or 
four summaries at a time but indicate to the 
user that they can turn the page to see the 
next set. Hook that up with a swipe gesture 
and a nice page curl animation and you have 
a much more natural way of flipping through 
the same material without needing to slide 
views in and out as the user moves through 
data. 

Are we going to have the same 
hardware issues with iPad as we did with 
iPhone? Specifically different capabilities 
and features? 

Absolutely. You already had that 
to some extent with just the first iPad— 
there are 3G iPads with a GPS while the 


Wi-Fi-only ones obviously don’t have 3G 
connectivity or a true GPS. The iPad 2 has 
two cameras while the original iPad doesn’t 
have any. iPad 2’s graphics and processing 
capabilities are substantially better, too. The 
good news is that you should handle it just 
like iPhone and iPod Touch differences— 
simply check for device capabilities and code 
around not having them. 

Does the iPad run a different 
version of iOS or anything? 

No; well, no more so than iPod Touch 
vs. iPhone. There are some controls that are 
only available on the iPad (and you need to 
check for them if you build a universal app— 
more on that later), but the basic OS is the 
same and you can have a single build that 
runs on all iOS devices. Speaking of running 
on lots of devices... 


Beliind 

the Scenes 



以⑽ 丄 a ' M 


Creating an for iPhone and iPad 


Now that you’re ready to build this thing, what exactly is it called? When Apple designed the 
iPad and iPhone to share one OS, Apple introduced the concept of a Universal app, an 
app that is built for both devices. That still means different views for iPhone and iPad, but 
only one code base that gets submitted to the App Store. Users get both a native iPhone app 
and native iPad app when they buy your application instead of needing to purchase two 
separate apps. 

Its a big factor in distribution, actually … 
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fireside chat 


Fireside Ghats 



Tonight’s talk ： Universal App Distribution or not? 


Universal: Two Apps: 

Ha! Two apps. That’s really inefficient. It really just 
makes more sense to support iPhones and iPads 
everywhere, like I do. 

You do support everyone, that’s true, but that makes 
you kinda hefty, right? You have to check for like, 
everything! 

True, but if I’m written right, most of my code is 
shared between the devices. It’s really not that hard 
to just use the right view controllers on the right 
device and everything else goes from there. 

See, my apps don’t have that much to worry about. 
If it’s iPhone, that’s it. Well, except for touches...but 
I don’t need to deal with everything in one.. 

I’d be happy to trade worrying about a couple more 
devices for better sales and reviews. 

Wait a sec. I’m really the moneymaker. If you build 
two apps, then you can sell twice per user. Every 
person out there with an iPhone and an iPad has to 
pay twice to get all of me. 

The reviews I see have a lot of people complaining 
about needing to purchase the same app again just 
to use it on another device. I’m usually a little more 
expensive, but users love getting more value for their 
money. 
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Hmm. I don’t buy it. I cost less but only work on a 
specific kind of device. 


migrating to iPad 


Universal: Two Apps: 

Let’s talk maintenance. I think we both agree that 
you don’t want two completely separate code bases, 
right? 

Oh, absolutely. Even if you are going to make two 
different apps, you should be sharing a code base. 
You definitely don’t want to be in a situation where 
you’re fixing the same bug in multiple projects or 
trying to keep them in sync. 


Totally agree. So I guess really we’re arguing about 
a packaging issue. Do the users want to pay a little 
more and get iPhone and iPad support, or do they 
want to pay a little less when they only want support 
for one device, but end up paying more if they want 
both? 


You know, I bet there isn’t a simple answer to that. 
There are lots of users who have lots of different 
opinions. It probably depends on the app and how 
the developer wants to interact with the users. I 
guess there’s room for both of us... 





Sam doesn’t want to deal with multiple applications. He wants 
the iPad version of DrinkMixer to be tied in with the original 
iPhone app. What kind of app distribution are we going to have 
to use? 
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building universal 


Use Xcode to build your Universal app 


Since we’re looking to support Sam and keep things easier, it makes more sense to build a 
universal app that creates one software bundle. This isn’t too hard to implement, because when 
the code is cleanly separated in the MVG pattern, we just need to talk to another view. 




this! 


Upgrade your app 

Highlight the project in the Navigator window and you’ll see the basic 
project settings. Make sure that Targets is highlighted. 

Under devices, the drop-down box will let you select iPhone, iPad, or 

Universal. Select Universal. 
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Targets are used in the build 
process. 

Xcode completes the build process based on the 
targets that you identify. A target keeps track of 
which files and the instructions of what to do 
with them for a build. We upgraded our target to 
be a universal build, so now it has everything it 
needs to build an app that runs on iPhones, iPod 
Touches, and iPads. 

As part of the upgrade process, Xcode introduced 
the new .xib for us and added it to the target. 



Gee| Bits 


Since Xcode is used for Mac development too, there are lots of 
reasons to create several targets, such as frameworks or libraries. 
Targets are frequently used to build unit tests or application 
tests as well. The test code is only included in the test targets 
and won’t be in the release builds. Xcode only builds the active 
target, so you can build just one piece at a time. We only have 
one target for DrinkMixer, so it’s always active. 
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test drive 




TesT DriVq 


Make sure that the iPad simulator is still selected for the build and build and 
run the app. It should look much more iPad-specific now... 




^ 2:22 PM 

獅％ 

Drink Mixer 



After Dinner Mint 
Aftershock 
Apple Martini 
BaKcd Apple 
Stinger 
Beetle Juice 
Black Eyed Susan 
Blue Dog 

Bookmaker's Luck 
Boxcar 
Cafe Joy 
Captain and Cola 
Cat 1 ^ Meow 
Cupid's Cocktail 
'Day at the Beach 
Deer Hunter 
Firecracker 
Flaming Nerd 
Gingerbread Man 
Key West Lemon a de 
Lemon Drop 
Letter Bomb 


ViOV*k* 




Ingredl^nls^ 

hazalnul liqu 叫 『.cpqqmil mm, in^li 


Dlr$diorfcS： 

Cpmbifie in b 

mug. Top wiEh whijDped cream 
and roconut shavings. 


VMo 七 rid oUk - “W 叫 kad^ss, 

U-t st«ll ^cU l.kc a., o^yro^ 

a?? … 
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migrating to iPad 


The detail view looks really bad, and ifs just 
a regular table view—we never told it to use 
the Split View Controller. 



You’re right. 

Since we’re working with 
iPhone and a new view, Xcode 
just ported what we had over 
to the iPad — in this case, a 
table view. To put the new 
Split View Controller into play, 
we need to fix that. 




Split-view Magnets 


y:’Xr 之 ？》 ^ 


Adding the split view isn’t really that hard if you think about it a bit. 
Use these magnets to order the steps we need to work through. 


Delete the 


Navigation 


Controller 


and add the 


Change the Table View to the Root 


Declare ana auu. 一 

UlSplitViewController instance 

variLle and its IBOutlet to t he 
DrinkMixerAppDelegate fi 


Add in the DrinkMixer Detail View 


View 
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magnets solution 



Split-view Magnets Solution 

Adding the split view isn’t really that hard if you think about it a bit. 
Use these magnets to order the steps we need to work through. 



This is the ihi-tial 
-file listmg that was 
by 

whch the hew 
tavget was ^veated- 


Delete the Navigation Controller 


TWis Nav •〜七 I。 灼 Coy\-tv-ollcv is 

伤 W a ? latcd W 如 a S 汁七 
Co^ollcv. So, dele 七 c 七 Wis 叫 
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migrating to iPad 



DrinkMix«r - MainWin<Jow-iPad.xib 


Add a Navigation Controller 

to the Detail View 




\/\C*i 


Co^WoWtr 

班二 r 


f r *% C wi ， r ， 


vih (Fnaliih) 




For the Split View Controller 
to work, you need to have two 
children. By default, they are 
a Navigation Controller with 
an embedded Table View and a 
standard view controller. We want 
a Navigation Control on top of 
the View Controller for the right- 
hand pane. Using a real navigation 
controller for the detail view gets 
us access to a navigation bar and 
the usual edit buttons, like we had 
for the iPhone version of the app. 




^ldY\ 


\OY\ 


Co^*tv*ollcv* 


hcvc 


This view is t\\\\d 
y\o- Z- 


View Control 


The easiest way to swap out the right view controller is to drag and drop 
a Navigation Controller into the right pane. Interface Builder will update 
the right view controller to be a Navigation Controller for us and drop the 
navigation bar right where we want it. 


Root 


View 


Controller 


CwW ⑽ . 1 ， 〆 
taWc ^ ^ 

Co^WoWtr 


View Controller 


DrinkMixer - MainWindow-iPad.xib 


Simulator t 


丁七七 U } 

look ^ 


DrinkMixer QjResources-iPad > /v MainWindow-iPad.xib (^) Split View Controller ^ Navigation Controller 



0 Placeholders 


1: File's Owner 

First Responder 


^0 Objects 

— i 



rv* Drink Mixer App Delegate 
Window 

▼ CJ Split View Controller 
▼參 Navigation Controller 
Navigation Bar 

▼ O Root View Controller - Drink Mixer 
Navigation Item - Drink Mixer 
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more magnet solution 



Split-view Magnets Solution (contJ 



DrinkMi 賊 f- nWindow-iPad.s*b 




©interface DrinkMixerAppDelegate : NSObject <UIApplicationDelegate> { 

UlWindow ^window; 

UINavigationController *navigationController; 

UISplitViewController *splitViewController ; 
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©property (nonatomic , retain) IBOutlet UlSplitViewController 
*splitViewController; 




DrinkMixerAppDelegate.h 
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DrinkMixerAppDelegate.m 



Right-click on the App Delegate and connect the splitViewGontroller outlet 
to the Split View Controller. 


Change the table view to the root view 

Jus-t like v/c did v/rth *thc dc*tail view, tUss -type -fov- table view don*brollcv 

*to w Root V\tvi Coirrbrollev " 广 



▼O Split View Controller 

W 1 Navigation Controller 
Navigation Bar 

Root View Controller (Root View Controller) 
■— Navigation Item (Root View Controller) 
Navigation Controller 


■ 


Navigation Bar 


{J View Controller (Root View Controller) 

■— Navigation Item (Root View Controller) 


UlSpI it Vi e wCon trol l€ r 
Ull Navigjit ionControlter 
JIISJavigationBzr 
RoaE Vie wCo nt ro I ter 
UINavig^tionltem 
Ull Mavigatio nController 
UINavigationEar 
LJIViewController 
UINavigjitioniltem 


o 


But the App 
Delegate is for the iPhone 
and the iPad, right? Don’t 
we need to tell it which 
view to use? 


t 
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who are you? 


Check your devices 


This is where the code paths for the iPhone and the iPad are going to intersect — in the 
App Delegate. Because we’re migrating an existing iPhone application, we already have 
an AppDelegate and it’s set up to add our RootViewGontroller to the window when the 
application launches. 

Now that we’ve added iPad-specific views, we need to update our AppDelegate to add the 
correct one to the window depending on the device. iOS makes it easy to determine which 
device you’re on through a macro named UI_USER_INTERFACE—IDIOMf). This returns 
a constant that tells you the type of device your application is running on; we can use this to 
figure out which view controller to show in the window. 




- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions 
: (NSDictionary *)launchOptions { 


// Override point for customization after application launch. 

// Add the navigation controller's view to the window and display. 

if (UI 一 USER 一 INTERFACE 一 IDIOM () == UlUserlnterfaceldiomPad) { 

[self.window addSubview : self.splitViewController.view] 

else { 

[self.window addSubview : navigationController.view]; 

[self.window makeKeyAndVisible]; 
return YES; 




鲁 




DrinkMixerAppDelegate.m 


Vow it’s reacty to run 
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TesT DriVq 


Save everything and then build and run. You may need to switch Xcode 
back to the iPad setting for the Simulator … 





To see tke split view，go up to 
tke Harctware ^Rotate Rigfkt 
menu option. 
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test drive 



Tltat isn’t 
working! 




TesT DriVq 


Rotating DrinkMixer should expose the Split View Controller that we’ve been working 
on. But there’s a problem... 
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migrating to iPad 


Rotation is key with iPad 

An important part of coding for the iPad is that is has to support all orientations, since Apple 
is big on there being no wrong way to use an iPad. Users will expect to be able to pick up 
their iPad any way and have it work. To start supporting all orientations, we need each of our 
controllers to know that we want to do that. 


This method is m all youv Vicy/ 

-f iles, jus*t out 


卞 

// Override to allow orientations other than the default portrait 
orientation. 

- (BOOL)shouldAutorotateToInterfaceOrientation:(UllnterfaceOrientation) 
interfaceOrientation { 

// Return YES for supported orientations. 

ret ， d-i'n {xirLerfciueCr iention 一 - 二 1 - 丄丄 ; 


return YES 


Remove *tKis Tmc vcplatc 

\i bo support all 

oV-icir\*ta*tior\S. 




* 


m 


RootViewController.m 

DrinkDetailViewController.m 
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test drive 



Tqst DriVQ 


Now you’re supporting all the orientations, everything is linked, and devices are checked. 
The split view should be working now... 


Drink Mixer 

After Dinner Mlint 

> 

Aftershock 

> 

Apple Martini 

> 

Baked Apple 

> 

Bee Stinger 

> 

Beetle Juice 

> 

Black Eyed Susan 

> 

Blue Dog 

> 

Bookmaker's Luck 

> 

Boxcar 

> 

Cafe Joy 

> 

Captain and Cola 

> 

Cat's Meow 

> 

CupkTs Cocktail 

> 

Day at the B^ach 

> 

Deer Hunter 

> 


Ingredient^: 


Directions: 


Now，pusk tke 
kome key anct 
launcli it again. 
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migrating to iPad 



Wait. The app looked OK once it got 
started, but something weird happened 
at startup. 


We’re not fully supporting rotations yet. 

The code is all set up to handle a rotation whenyou y re in the app. 


At startup, iPad apps should show a launch image first, while they’re 
loading, like a splash screen. Apple’s HIG recommends that the 
image should be your actual initial user interface (minus specific 
data). Depending on the application, though, some people use 
actual splash screens. 

Once the images are set up, iOS will pick the image that goes with 
the current orientation and avoid that awkward rotation of the 
interface that you saw without appropriate launch images. 


i^harpen your pencil 


We have two images you can use for launch images, you just 
need to download them and drop them in your project. 


Go to http:/ / www.headfirstlabs.com/books/hfiphonedev and download the 
launch images for this chapter. 


Select the project in Xcode and scroll down to iPad Deployment Info. 
Enable all four support device orientations. 


Drop the portrait launch image into the Portrait Launch image box 
and the landscape image into the Landscape Launch Image box. Let 
Xcode copy both into your project. 
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sharpen solution 


Sharpen your pencil 


k Solution 


We’re just about ready to fully support the launch in any 
orientation. Here’s what your final resources directory should 
look like. 


yj ^ouid 

seized 





Interface 


Device Orientations 


Portrait 


Upside 

Down 


Laridscapf Landscape 

Left Right 


Retina Display 




MairWi ndow-iPad 


Wo 

image 

specified 


No 

image 

specified 


n n a 4 ^ 


will h^vc sdded iUe - ^ 


Df]nkMiier 

1 target, i05 SDK 4.3 


Default=LandscApe~ipad.png 
De It- Po rtrait-i pad. p ng 

Classes 
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Tesr DriVq 


Now we’re supporting all the different orientations, right from the beginning. Try 
stopping it and relaunching in the simulator from landscape. Everything works! 
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test drive 




TesT DriVq 


Cottt^ lue ^ < 


What if you tap on one of those rows in the horizontal split-view orientation? 



Thafs not right! 
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BE th^ 35 顿 1 

Your job is to play Detail View Controller 
figure out A^iy you’re not displaying tire ri^lrf: 
tiling. Look at tire code below and see if you 
can figure out Azat’S ^oin^ wrong 



W\\cy\ does -this ^ode actually yt 

tailed? 


(void)viewWillAppear : (BOOL)animated j 
[super viewWillAppear:animated]; 


DrinkDetailViewController.m 


// Setup our UI with the provided drink 

self.nameTextFieId.text = [self.drink objectForKey : NAME KEY]; 

Self . ingredientsTextView . text = [self.d^n, _ 

objectForKey:INGREDIENTS_KEY]; 

self.directionsTextView.text = [self.drink objectForKey:DIRECTIONS 

KEY]; 


W\\tY\ should i*t 匕 ailed? 


classes av-c you h> y\tcd *fco upda-tc? 


iVhats between the iPad a^d 

■the iPhone? 
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be the solution 


级 BE • D 蝴 1 AW C 神伽 

腿 Your job is to play Detail View Contvollev 
and figure out A^iy you’re not displaying 
、 tire ri^lrf; tiling. Look at tire code below 
' tV 、 - myd see if you can figure out 

Azat’S going wron 贫 … 


燦 



W\\cy\ does -this actually yt 
called? 


viev^lV»ll/\ppea\r QjrU called oy\ly y/he^ -fche 

vigy/ yis prgsgh-fcgd bo 七 tig user, hloj as 

■the user *m*tcrad*U y/i*th *the view. 


一 (void)viewWillAppear : (BOOL)animated j 
[super viewWillAppear:animated]; 


# 


m 


DrinkDetailViewController.m 


// Setup our UI with the provided drink 

self.nameTextFieId.text = [self.drink objectForKey : NAME KEY]; 

Self . ingredientsTextView . text = [self.dr.n, _ 

objectForKey:INGREDIENTS_KEY]; 

self.directionsTextView.text = [self.drink objectForKey:DIRECTIONS 

KEY]; 


should i*t called? 

The detail view heeds bo be updated 

eadh -time -the user selects a row. 


lVha*t classes av-c you -fco v\ttA b> update? 

tVmkDe*bail\/iey/Coyrbrolle\r, _ 

Roo-tl/icwCoh-tv-ollev- 


l/Vhats the di-f-fcv-c^dc hcv-c bc*tv/cc^ iPad d^d 
*thc iPhone? 

That vgs^vamed higravdhy •bhihQi. The iPhone has 

•fco show 七 wo di-C-fergh'fc views -for -bhe de-b^il view 
a^d the \roo 七 view. Smde -fche views are •fcoylhcv 

-for 七 he Split V\tvi Coyrbroller on 七 hg iPad) 七 he 

view isy / 七 bemq pvgseyrfced, bu 七 i 七 s^ill has jo 
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migrating to iPad 


A persistent view problem 


We built things for the iPhone to populate the detail view when it’s about to be 
displayed. The problem is that with the iPad version, it’s always displayed. What 
worked well on the iPhone (repopulating the data as the view was presented) doesn’t 
work well on the iPad, since it will only get one viewWillAppear message — right after 
the app launches. So what should we do? 

The wrong solution would be to duplicate our viewWillAppear code. We’re better 
developers than that, so we’re going to refactor the code into a new method in the 
DrinkDetailViewGontroller called refreshView that will repopulate the view when 
the drink changes (via a drinkGhanged method). 




It 

r\ccds V 



■ fills! 



(void)viewWillAppear : (BOOL) 


animated 


_ 1 

•Mft 彳 



_ 一 


[super viewWillAppear : animated] ; OVA y- 

[self refreshView] ; ^ ——-- - 


DrinkDetailViewController.m 



TW.s -,s code tKat Kas ?ullcd ^ 


(void) refreshView { 

// Setup our UI with the provided drink 

self.nameTextField.text = [self.drink objectForKey:NAME—KEY]; 

self.ingredientsTextView.text = [self.drink objectForKey:INGREDIENTS_KEY]; 
self.directionsTextView.text = [self.drink objectForKey:DIRECTIONS KEY]; 



(void)drinkChanged:(NSDictionary *)newDrink { 

self, drink = newDrink; ovav 

[self refreshView]; 


delegates to 




ouv V>C>M 


- (void) refreshView; 

- (void) drinkChanged:(NSDictionary *)newDrink 


@end 


DrinkDetailViewController.h 
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tableview fixing 


Pow't forget the tableview 

Instead of swapping out the table view when a row is selected, 
the detail view needs to change and the table view should stay 
the same — but only for the iPad, not the iPhone. 

To fix that problem, we need to split the code, just like we did 
in our AppDelegate. 








fMs? ♦ 


咖 n °" C? , L . A T u c W V,as 


@class DrinkDetailViewController; 

@interface RootViewController : UITableViewController { 
NSMutableArray *drinks_; 

UIBarButtonltem *addButton_; 

DrinkDetailViewController *splitViewDetailView ; 


©property (nonatomic, retain) IBOutlet DrinkDetailViewController 
*splitViewDetailView; 




RootViewController.h 


@synthesize drinks=drinks_, addButton=addButton_, splitViewDetailView=spli 
tViewDetailView ; 



(void)dealloc { 

[splitViewDetailView release] 



RootViewController.h 


[drinks— release]; 
[addButton 一 release]; 
[super dealloc]; 
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a 灼 



- (void)tableView:(UITableView *)tableView didSelectRowAtlndexPath:(NSIndexPa 
th *)indexPath { 


if (!self.editing) { 

if (UI USER INTERFACE IDIOM() 


UlUserlnterfaceldiomPad) 


[self.splitViewDetailView drinkChanged:[self.drinks 
objectAtlndex : indexPath.row]]; 


else { 

DrinkDetailViewController ^detailViewController = 

[[DrinkDetailViewController alloc] initWithNibName:@〃DrinkDetailViewControll 
er 〃 bundle : nil]; 

detailViewController.drink = [self.drinks 
objectAtlndex:indexPath.row]; 

[self.navigationController pushViewController : detailViewC 
ontroller animated:YES]; 

[detailViewController release]; 


else { 

AddDrinkViewController *editingDrinkVC 
[[AddDrinkViewController 




RootViewController.h 


Tesr DriVq 


Before you build and run, go into Interface Builder and link up the detail view in the split 
pane to our new split ViewDetailView property on the RootViewController. Now you’re 
pushing the detail view onto the right-hand side of the pane, while the left-hand side is 
still showing the table view. 
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test drive 




TesT DriVq 


Build and run the application. Now you’re pushing the detail view onto the right-hand side 
of the pane, while the left-hand side is still showing the table view. 



Every tiling’s working! 
In landscape at least... 
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migrating to iPad 



But if you rotate 
the thing, it still 
doesn’t look right. 


Right. 

To fully implement the Split View Controller, we 
need to have the popover working in the portrait 
view. If it doesn’t, the user will be stuck in the detail 
view unless they rotate back to landscape. 







Match each control in the landscape view (table, detail view, nav control) to its 
equivalent in the portrait view. Then you’ll have an idea of what needs to go where! 


Landscape 


portrait 
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who does what solution 



Sou' 




Match each control in the landscape view (table, detail view，nav control) to its 
equivalent in the portrait view. Then you’ll have an idea of what needs to go where! 


? 9 Ttr£& 


TWis button rtccds -to be Creaicd, s\Uc i*t docs^i 
{jo anyH … 3 speti-fit m la^dsdapc- l*t Will pv-csc^-t 

pofovcv-. 


nt lUiAE 


Bd 峰 (1 Ap_ 

3 *# 

&h4Ib Julev 

Evcd $uum 




t >w a v 

kibi j 




Boilii^TKlkCf'B Luc 


Cofftsin and Cola 


B«eh 

&Mf 


Drinks 


MXt'H 




Present the popover! 

The UISplitViewGontroller, while awesome, doesn’t do anything except manage the 
two views inside it. When the iPad is rotated to portrait, the views that we’re working 
with are the same, just like you saw in the exercise. While DrinkMixer supports the 
detail view in portrait, we need to enable the other hidden view, the table view. We’ll 
do this with the popover. 

The popover is an iPad exclusive control that is used to present a table view 
temporarily, just to allow the user to select another detail view and keep working 
with the data. To manage moving the views around, we need to conform to the 
UISplitViewGontroller delegate protocol and present the popover. We also need to 
set up a button to allow the user to access the popover view in the navigation control 
of the detail view in portrait. 
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migrating to iPad 



ExeRclSe 


Go dive into the documentation and find out about the UlSplitViewController delegate 
protocol. Use that to figure out how to implement the items below. 



Add the UlPopoverController to DrinkDetailViewController.h. 

Create an instance variable named popOver_ and a corresponding 
property that’s an IBOutlet. 



Synthesize and dealloc popOver— in DrinkDetailViewController.m. 



Implement UISplitViewDelegate methods in DrinkDetailView 
Controller, m. 

Get started based on what you can find in the documentation. We’re going to 
implement the button in code. If you get stuck, it’s on the next page. 



Use Xcode to edit the view so that the SplitViewController 
delegate outlet is connected to our DrinkDetailViewController. 

You’ll have to open up the iPad main window and expand the Split View 
Controller to make the connection. 
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long exercise solution 


M 


Exe^ctSe 
SoLytioH 


Once you’re finished implementing the Split View Controller delegate, it can handle 
all the information properly in landscape and portrait. 


o Add the UlPopoverController to DrinkDetailViewController.h 

Create an instance variable named popOver_ and a corresponding 
property that’s an IBOutlet. 


Qinterface DrinkDetailViewController : 

<UISplitViewControllerDelegate> { 

@private 

UITextField *nameTextField—; 
UITextView *ingredientsTextView 
UITextView *directionsTextView—, 
UlScrollView *scrollView_; 
NSDictionary *drink_; 
UlPopoverController *popOver ; 


UlViewController 


©property (nonatomic, retain) UlPopoverController *popOver; 



❻ Synthesize and dealloc popOver_ in 
DrinkDetailViewController.m. 



DrinkDetailViewController.h 


Qsynthesize drink=drink_, 
nameTextField=nameTextField—, ing 
redientsTextView=ingredientsTextVi 
ew—, directionsTextView=directions 
TextView—, scrollView=scrollView__ / - 
popOver=popOver ; 





DrinkDetailViewController.m 



- (void)dealloc { 

[nameTextField— release]; 

[ingredientsTextView_ release]; 
[directionsTextView_ release]; 
[scrollView 一 release]; 

[drink— release]; 

[popOver 一 release]; 

[super dealloc]; 
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migrating to iPad 


o Implement UISplitViewDelegate methods in DrinkDetailViewController.m. 

Get started based on what you can find in the documentation. We’re going to implement the 
button in code. If you get stuck, it’s on the next page. 



#pragma mark - UISplitViewDelegate methods 

- (void)splitViewController:(UlSplitViewController *)svc willHideViewContr 
oiler : (UlViewController *)aViewController withBarButtonItem : (UIBarButtonlt 
em *)barButtonItem forPopoverController : (UlPopoverController *)pc { 

barButtonltem.title = @ 〃 Drinks 〃； 

[self.navigationItem setLeftBarButtonltem : barButtonltem animated:YES]; 

self.popOver = pc; TV^'is mctKodi will be tailed by sfliWicwCohtrollcv- 

x ,-t V^as -to Wide 1 说七山 iew wbro le' Ths method 

a P o P over Roller wc use to 

sKoy/ -bKa-t K'lddeh View 一⑼从仪命 Y. 

- (void) splitViewController : (UlSplitViewController *)svc willShowViewContr 
oiler : (UlViewController *)aViewController invalidatingBarButtonltem : (UIBarB 
uttonltem *)barButtonltem { 

[self.navigationItem setLeftBarButtonltem : nil animated:YES]; K 

self.popOver = nil; 丁 ^ yts ddlled 诎⑼ ^ spl.tV.cy/Co^ollcv 」 

} d view 冰 broiler b 把 k. ^ jus 七 

W*tW 




DrinkDetailViewController.m 
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long exercise solution 



炙 oh 苢 ExedctSe 
SoLutioH 


o 


Use Xcode to edit the view so that the SplitViewController delegate 
outlet is talking to the DrinkDetailViewController. 

You’ll have to open up the iPad main window and expand the Split View Controller to 
make the connection. 








this! 

One last thing—the drinkChanged 
method needs a quick update. 


(void)drinkChanged:(NSDictionary *)newDrink { 
self.drink = newDrink; 

[self refreshView]; 

if (popOver 一 != nil) { 

[popOver 一 dismissPopoverAnimated : YES] 

}' 


Hcv-c >wc wake SUV-C -to dismiss ouv- popovcv- 

4 七 k UW selects a a^rmk. 




DrinkDetailViewController.m 
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Tesr DriVq 


Everything should be working now! Try using 
the button and rotating the simulator. 






























no dumb questions 


Q/ The detail view still doesn’t look all 
that great. Shouldn’t we fix that? 

If we were going up on the App Store, 
yes. In our next iPad app, later in the book, 
we’re going to focus a lot more on look and 
feel. For now, we wanted you to get the 
controls figured out. 

When we enabled various launch 
orientations in Xcode, what did that 
actually do? 

If you take a look at your Info.plist in 
your project, you’ll see that Xcode quietly 
added an array of enumerations that list the 
launch orientations you support. The GUI 
option we used is just a convenience (and 
new in Xcode 4) for setting those values. 
iOS looks at your app’s Info.plist to figure out 
what launch orientations it can use. 

You mentioned the ~ipad thing was 
standard. Standard for what? 

Before the iPad, launch screens were 
simply named Defaulting, then Default- 
Portrait.png and Default-Landscape.png. 
Once the iPad entered the scene, Apple 
added the concept of 〜 <device> to filenames. 
iOS will pick the most appropriate file based 
on device type. It does something similar 
with the @2x notation for high-resolution 
(iPhone 4 Retina display). 


ihere^ecce no o 

Dumb Questi9ns 


Are popovers only used with Split 
View Controllers? 

Most definitely not! Popovers are used 
pretty often in iPad applications. They’re 
very straightforward to use—they simply 
wrap a view and you can tell them which 
control they should appear next to. See the 
documentation for UlPopoverController for 
more information. 

We really didn’t do much to 
support the various screen orientations. 

Is that normal? 

It really depends on your application. 
When you edit the size information of a 
control in Xcode, you can set its Autoresizing 
properties. With those properties, you can 
anchor a control to the top, bottom, or sides 
and control whether it stretches when the 
view changes size (which is typically due to 
a rotation). If you’re using roughly the same 
layout for both landscape and portrait (which 
we are, minus the table view), you can use 
Autosizing to get you what you want. 

For more complicated views, you might hide 
or show entire controls or resize and re¬ 
layout controls depending on the orientation. 
There are a number of view controller 
callbacks that will get called while the view 
is rotating to its new orientation, and in 
there you can update the size, position, 
and visibility of your controls if necessary. 


Typically, you’ll use view animations here to 
make sure things transition smoothly. 

What happens if I try to use a 
popover on the iPhone? 

Very, very bad things. There are 
controls and features that only exist on a 
particular device (and within a particular iOS 
version). When the iPad first came out, you 
couldn’t even rely on there being a class 
name UlPopoverController on the iPhone. 
Now that’s gotten a little simpler, but you 
must always check that you’re on a particular 
device or that the device has the feature you 
are about to use before trying to do it. 

Depending on what versions of iOS you 
support, you will also need to check to make 
sure certain classes exist before doing 
anything with them. For example, older code 
will often have the popover reference we 
added in the detail view controller declared 
as type “id” since you couldn't assume 
the UlPopoverController was a valid type 
on iPhones. If you support old versions of 
iOS, you’ll need to do the same. Apple has 
excellent documentation on writing backward 
compatible code that you should look into if 
you’re going to support older versions of iOS. 


356 


Chapter 7 




migrating to iPad 



iPad Cross 


Let’s get the right brain working. Here are some 
vocab words from your first iPad chapter. 



Across 

3._is what you're doing when you implement 

code that differs by device 

7. This control is iPad specific and controls other views. 

9. These are not just big iphones 
10. iPads need to support all_. 


Down 

1 ■ This control is used only on iPad 

2.Apps compiled for both iPhone and iPad are 

4_ The Split View Controller keeps track of_views 

5. To implement the popover, you need to add a_to 

the portrait view. 

6. This covers Ul for iPhone and iPad 

8. The images display when the app is starting up 
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iPad cross solution 



iPad Cross Solution 

Let’s get the right brain working. Here are some 
vocab words from your first iPad chapter. 



Across 

3._is what you're doing when you implement 

code that differs by device [DEVICECHECKING] 

7. This control is iPad specific and controls other views. 

[SPLITVIEWCONTROLLER] 

9. These are not just big iphones [IPADS] 

10. iPads need to support all_■ [ORIENTATIONS] 


Down 

1 _ This control is used only on iPad [POPOVER] 

2. Apps compiled for both iPhone and iPad are [UNIVERSAL] 

4. The Split View Controller keeps track of_views 

[CHILD] 

5. To implement the popover, you need to add a_to 

the portrait view. [BUTTON] 

6. This covers Ul for iPhone and iPad [HIG] 

8. The images display when the app is starting up [LAUNCH] 
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migrating to iPad 



Your iOS Pevelopment Toolbox 

You’ve got Chapter 7 under your belt 
and now you’ve added a bunch of iPad 
controls to your toolbox. 


Pad W\ 6 j 


Thc\rc a\rc iPad-spcdi-fid dohtv-ols, 

3 hd some \rulcs di*Pfe\r bc*ty/cch 

iPhohC 3 hd iPad. 

The Split \/icw Coh-tvollcv dhd 
pofovc\rs a\rc iPad-spcdi-fid doh-tvols. 


PcvidC 

Oi\tt you build d U^ivcvsdl 
you'll Yittd bo -fov diHev ⑼七 

devils so youv 6 扣 behave 

di^cv-c^-bly as needed- 


Whivcirsal Afps 

Dcpchdihg Oh how you w^ht *to 
distribute youv app, you d^h 
build *two 3pps o\r d Uhivcvsal 
app. Uhivmal apps Ohly sold 
oUc, but they doh-bih dodc 4v 
bo-th the iPhohC ahd iPad, whidh 

makcs ^^ihtchah^ casicv 3hd the 
^us*tomc\rs hdppy. 


l/icw Cohtvollcv 

y hiS ^^ollcir ； s job is t> keep 

^ /hild views that avc 
Asp ayed di^cmchtly i h pov^ait 

ahd lahd 似 you se £ i£ 

up you have a sr，all 

dStc f vicws ihai displa y '°^ ^ 


you are here ► 


359 













8 tab b^rs 印 id Cote D 收 1 

% Ehicv-pvisc 

Bounty hmter s^pps ^ 



Heres what I Ve found ： we 
just can’t be competitive 
anymore without an iPhone app! 


Enterprise apps mean managing more data in different ways. 

Companies large and small are a significant market for iPhone and iPad apps. A small 
handheld device with a custom app can be huge for companies that have staff on the go. 
Most of these apps are going to manage lots of data, and since iOS 3.0, there has been 
built-in Core Data support. Working with that and another new controller — the tab bar 
controller — we’re going to build an app for justice! 


this is a new chapter 
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iboib’s on the go 


HF bounty hunting 



O 


o 


❺ 


o 


With my business, I’m out of the office a lot. 

The courts will let me submit evidence from my iPhone 
now, so I need an app for that to get paid. I picked 
up an iPad while I was at it, since I figured it would 
help me do more detailed research during boring 
stakeouts. Can you help me with some apps for 

both? 


Bob needs some help. 

Bounty hunting is not a desk job; Bob needs lots of 
information to pick up fugitives on the go. His iPhone is 
ideal to take along while he’s chasing bad guys, while his 
iPad will great for more detailed background work. Here’s 
what Bob needs in his apps: 


Bob *thc bouh~ty 




o 


Rsd App 


jPKo^e Ap^ 


此⑽咖 加 %itive was doing 


Bob needs a list of fugitives. He , 
has to keep track of everyone he s 
looking for, along with people he s 
iptured. 


❺ 


ca 


He wants to be able to quickly 
display a list of just the captured 

fugitives. 

He also needs a display of the 
detailed information about each 
fugitive, like what they’re wanted 
for, where they were last seen, and 
how much their bounty is. 


o 


there. 


J° r reSearch ^ B ob needs the full 

n e h fugitive Picture 

sa^e ：Lt ° Uld a11 bC m the 

:=== 一 — 
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tab bars and core data 



Jim: OK, so he wants the entire package, iPhone and iPad. 
Where do we start? 

Frank: Well, we’re going to want to create another 
universal app. 

Joe: Right, then we can keep the logic and everything 
together, just like we did last time, but with different views. 

Jim: OK, so what do we do first? 

Joe: What if we start with the iPad, write that, and then do 
the iPhone, since it’s smaller? 

Frank: Two things. First, we need to design everything. 
Jim: Why? 

Frank: Because we want to figure out what the two views 
will have in common and make sure it’s set up right. 

Jim: Oh. 

Frank: Second, since the customer gets paid based on using 
the iPhone app, pretty sure he’s going to want that first. 

Joe: But it’s smaller! I think we should do the hardest one 
first. 

Frank: Listen, we work for Bob and this is what he wants. 
Joe： OK, so the plan is... 

Jim: We’ll start with designing both views, then code up the 
iPhone and the backend together. 

Frank: Right, then we can lay the iPad view on top. 

Jim: OK, let’s get started. 
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universal benefits 





/Wake \i 


I Oh 





s 


If you’re planning on supporting both devices from the beginning, it’s best to start 
with an app set up to do just that. Remember, a universal app comes with all this 
stuff built right in: 




One binary file to maintain. 

The files will compile together and support both devices. That means 
that changes only need to be tracked once. 




UIs will be separate. 

Universal apps have two separate view controllers and Interface Builder 
files, one each for the iPhone view and the iPad view. 




Shared code needs device checking. 

Since all of the logic code will be shared (if we do our job right), there’s 
going to need to be more device checking than before. Instead of just 4 
generations of iPhones and iPod Touches, you’ll also need to watch out 
for iPad-specific stuff. 




Universal apps are sold once, used twice. 

The way the App Store is set up, universal apps are sold as an app 
that will run on both devices. Users buy the app, put it in their iTunes 
libraries, and then those who have iPhones and iPads can install it on 
both as a native app. It may look and act differently, like iBountyHunter 
will, but you only get paid once. ^ 

Its somethihg io dohsidc\r. The iPad app 

sW is +ull <^p XD ahd XL vevsiohs o-p 

a PP s that you da” -Pov- 
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Now ior some UI work.** 


tab bars and core data 


i^iharpen your pencil 



Now, what is this iPad app going to look like? Since iPad apps 
MUST support both landscape and portrait, you need to think 
about both. 


Povbrai 七 Ov-ici^*ta*tio^ 





Rcrwcrwbc\r—the 
you -to have 

di-f-fc\rc^-t—looking views 
-Po\r 七 he di-f-Pc\rcr>i 
o\ric^-ta-tio^s... 
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sharpen solution 


%Aarpen your pencil 
^ Solution 


Here’s what we came up with for this iPad app — don’t worry if 
yours is a bit different! Since iPad apps are expected to support 
both orientations differently, we’re using the Split View Controller 
that we used for DrinkMixer. 


To sV^ow list o( v/cll 

a fofovcv- -tiia-t affcav- m 
toyy\cv- *tWis -full list 



IjVc II sdd some 
*»uh Ul "touches ； 

like 3 pushpih 

holdihg -the 

dcs 匕 Hpti 0h . 
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tab bars and core data 


Fo\r "the IdhdsddpC view^ wc ； ll 
"the -Pull lis-t o( -rugi-tives displayed ； 
s'mdc we have extv-a spade. 


Move IXI goodness ： too\ page 
ba 乙 kyound 七 looks like a 
dov-kboavd 



favigatioi^ 匕。灼 *brol 


JSL 




Lis*t o( -fugitive 

MsvnCS 

L 

U 

r 



Fugitive Name jq 

Fucjiiive ID#^ 

"Bounty ： 


This area is ^oy ~ 
y\q{,cs ay\d details - 
about 七 he -ru^itive- 





Map o( previously 

khov / 的 lodatio^s 


]/^\\tY\ Bob selects av\ tvybr^j) 
a U|WcW'»cv/ y/'ill d's^laY 
HTML.--fo\rmattcd W 七 
dcstv-ifem^ si^vb 呼 

^o\r *t^C -furtive. 


TKc maf Will hav/e 
pusKpms (or cadK 
lod 3 *tioy> lo^ovm -fov* 

•the -fugitive- 


Wt\\ have 七 lie batkyouv>d (or 
七 he look like notebook f3fcv*. 
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tab bar up close 


A wew iPhowc control 

Now that we’ve designed the larger interface, we need 
to get into the iPhone views. In some ways, designing 
an iPhone view after an iPad is more difficult. Smaller 
screen size and shorter interaction times are the key 
things to consider in creating this view, especially when 
there’s plenty of data to display. 


To leverage the smaller screen, we’re going to use a new 
controller: the tab bar. 



Bar Up Cl^se 


iP w A?? 

A Bob needs a list of fugitives. He , 
has to keep track of everyone he s 
looking for, along with people he s 
captured. 

He wants to be able to quickly 
W display a list of just the captured 

fugitives. 

He also needs a display of the 
detailed information about each 
fugitive, like what they’re wanted 
for, where they were last seen, 
and how much their bounty is. 


The Tab Bar Controller is another common iPhone 
interface. Unlike the Navigation Controller, there 
isn’t really a stack. All the views are created up front 
and easily accessed by clicking the tab, with each 
tab being tied to a specific view. 

Tab bars are better suited to tasks or data that 
are related, but not necessarily hierarchical. The 
UITabBarController keeps track of all of the views 
and swaps between them based on user input. 

Standard iPhone apps that have tab bar controllers 
include the phone app and the iPod. 


ihc^selvcs ^ 

^d/ 

olr 办 i^c. 


The tab 

bd\r 63y\ 

匕 oivtaih 

3 hy view 
you heed- 
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tab bars and core data 


%|terpen your pencil 


Take a second to go back to Bob’s requirements and your iPad Ul — think 
about how many views you’ll need for the iPhone version and then 
sketch up what you think you’ll need to build. 
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tab bars easily access multiple views 


Sharpen your pencil 
< Solution 


For the iPhone app, we’re going to need three views. 
Using Bob’s parameters, here’s what we came up with. 


o 


Bob needs a list of fugitives. He keeps 
track of everyone he’s looking for or 
has captured. 


o Bob wants to be able to quickly display a 
list of just the captured fugitives. 


Fo\r cadh list, 
well use a 
*t^blc view, like 
we did with 
D\rihkA 1 ixcv-. 


lA/c’ll keep -bv-atk 
%,t»vc dala sorbed W 


C.irrinr 乎 


：44 PM 




Ust OT 7v3mCS y 

、乂 j 












V 

- ~ - — 

rfugittves , 




The «\uidkcsi v/ay b> sv/i-Uh brUe ⑶ 
di-f^c\rcir>t lists is Y/iih a tab bav* 
do^iv-ollcv-. 



L—Captured 



lis*t o( 
















( i ,! 



i\\t tab bav- toyrbrollev" ， 七 he user 

di 乙 k on the tab at the botW 

-bV^c s^ccn *to jump beWa views. 
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tab bars and core data 


Sharpen your pencil 
< Solution 


❺ Bob wants a separate display with 
the detailed information about 
each fugitive. 



TV>c detail vicv/k 
cat\\ -fuy-bWc Will be 
available by 


a^Y 


y\dmC- 


For -these 

da*ba ； wcVc go*m^ to use a 

-tcdhholo^y m*broduded wi*tK 

■the ^.0 iOS SDK Core Data* l*t 

dan rmaha^e a lo*t o-f diAfeverrt 
data types -for your app. 



TV\\s avea is -fov 
y>o*tcs av>d dct 3 »l s 
afeou*b *b^c -fuy*bWc 


"The -bb bav- 
^hroWtY will siill 

be visible. 


Why are there so many Ul touches 
in the iPad version? 

The iPad is all about eye candy, so 
we're going to show you how to add some! 
To get an idea of the importance of realistic 
Ul to Apple, go check out the iPad HIG. 

Another good way to get an idea of what 
they’re focused on is to go play with the 



Mail app on an iPad. There are a lot of little 
touches aimed at realism. 

How do I keep track of integrating 
the iPad and the iPhone Uls together? 

Good question. Now that we have the 
Ul worked out for the iPad, it’s a good idea 
to sit down and make up a list of the fields 
that we’ve included. Since the iPhone app is 
smaller, we should take the iPad list of fields 
and pick and choose the ones we need. 


Can I embed a Navigation Control 
inside of a tab bar controller? 

Yes, you can, but NOT the other way 
around. If you have too much information 
to fit within one tab, but the contents are 
related, this may be the way to go. 
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which template? 


Choose a template to start 
iPouwtyHuwter 

This time around, we have a lot going on in our app. A universal 
app with a Navigation Controller, a tab bar, and Core Data, too. As 
we saw earlier, the only template that supports universal apps right 
now is the window-based app; so we’ll start there and add the tab 
bar and the Navigation Controller with Interface Builder and a little 
bit of code. 



A^-tcv vou -bV>c WmdoY/-bascd 
a?? kat.o„ 7 ou a.alo a W 


Select w u^ivc\rsal w as 
the Device Family. 


Choose options for your new project. 


Karwc "the pv-odud 七 “iBouovtyttujvtev”. 


Product Name iBoun^Hwriter 
Company identifier cornelement84 

Bundle Identifier comi.eIement84,iBountyHunter 


Next 


Previous 


^ akc ihc Use 

box is 
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tab bars and core data 



I just checked out the new file folders. 
They re completely different than what we 
had earlier when we upgraded our target to 
be a universal app for DrinkMixer. 


Yes! 

This app is being designed with two 
front ends in mind from the start. That 
means that we need to be smart about 
how we split up the functionality, with 
some of the logic shared for both UIs 
and some for each device. 

Let’s take a closer look... 
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sharing is iOS caring 


There's a different structure for universal apps 

Since we’re starting out building an app that will build for both devices, there’s a 
different structure from the beginning. Some logic will be shared between the two 
devices, like data management, while the UI logic will be separated for each device. 



[[BounryHunter I iPad 4.3 Sim 


O® B' 


Shaded lo^id ； mostly 

*foV us. 

All "the -files hc\rc av-c -Pov- 
iPho^c, mdudir^ -the view. 


WUk Os w 
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____V 

n ^ Ubel - My Universal Appo^ 


EBountyHuntcr 

LJ 1 target iOS SDK 4.3 

iBount/Hunter 

h i Bou ntyHun te rAp pDe le gate, h 
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iBou nt/Hunte r.xcdatamodeld 

iPhone 

h iBounwHunter...legateJPhone.ti 
m iBou ntyH un te r. .. I eg ate_i Ph one. m 


▼ □iPad 

h i Boy ntyH u nterAp pDe! eg ate _i Pad.h 
m , jB qu ntyHunte r. . .De_at.e_iiPad.m 
a MiaifiWi nefow_i Pad. x i b 
门 Supporting Files 
Q Frameworks 
pi Products 


Vow tkat we kave tke 


iiles in place, let’s locus 
on tke iPkone stuff first... 
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tab bars and core data 



Jim: OK, what do we do now? All we have is an empty view. 

Joe: Well, we need to add two table views, the tab bar navigation 
controller to switch between those views, and the detail view. 


Frank: So do we need a bunch of new nib files to handle all 
these views and controls? 

Jim: Ugh. This basic template gave us nothing! 

Joe: It’s not so bad. I like to think of it as a blank slate. Let’s see, 
we can start with the tab bar and tab bar controller... 

Frank: Right, that will switch between the two table views 
for Fugitive and Captured. Those views will each need nav 
controllers as well, to get in and out of the detailed view. 


Joe： So do we need separate nibs for the tab bar and those two 
views? It seems like maybe we could have all those controls in just 
one nib, for the tab bar and the two views, since they’re basically 
the same. 

Jim: Yeah, but we’d still need view controllers, headers, and .m 
files for each of those views. 

Joe: Yup, they’re the views that need the tables in them. We’d 
also need a detail view with it’s own nib and view controller, with 
the .h and .m files, right? 

Frank: That sounds about right. We can use Interface Builder to 
create the tab bar and navigation controllers. 


Joe: What do we do about the rest of the stuff? Add new files in 
Xcode? 

Frank: That’ll work — like before, we just need to specify that the 
nib files are created at the same time, and we should be good to go. 


Jim: I think that all makes sense — it’s a lot to keep track of. 

Joe: Well, we’re combining like three different things now, so it’s 
definitely going to get more complicated! Maybe it would help to 
diagram how this will all fit together? 
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iBountyHunter bird’s-eye view 

Prawiwg how iPouwtyHuwter iPhowc works... 

The main tab controller is going to be responsible for presenting a few different views 
to the user, and our data will be stored in a SQLite database. Putting all this info 
together is definitely easier if you can see how it all works. 


I/Vcll s*to\rc 
ouv- data m 
a S6^Li*tc 
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tab bars and core data 


•••awd how it fits with the universal app 


The AppDelegate_Shared class works for controlling views and data within the entire 
app structure. Once you get into either the iPhone or the iPad app, each one has its own 
AppDelegate to control the views and data within each individual app. 


Co 灼 all -the Cov-c Data 
^~ sc*tuf todt -fo\r hook'm^ up *to ou\r 

-fujiiivc dldid- 



AppDelegate_ 

Shared 






AppDelegate 

iPhone 




a,a ? ass e s iPWe v 〜 • 




Bo-feh 

^s subd^ss ih c 


CD 


AppDelegate. 

iPad 


o 


Now tkat you know kow 
tke views all lit togetker... 
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cubicle conversation cont. 





Joe: That helps a lot. So we only need two nibs: one to handle 
the controls for the tab bar switching between Fugitive and 
Captured views and another to handle the detail view. 

Frank: I get it. We need to put the table view components 
somewhere, and we can either create new nibs for each view and 
have the tab controller load them... 

Jim: ...or we can just include it all in one nib. Easy! 

Frank: Exactly. Since we don’t plan to reuse those table views 
anywhere else and they’re not too complicated, we can keep 
everything a bit simpler with just one nib. 

Jim: And we need view controllers for the two table views, 
along with the detail view. They’ll handle getting the right data, 
depending on which view the user is in. 

Frank: Plus a Navigation Controller for the table views to 
transition to and from the detail view. 

Joe: I think we’re ready to start building! 

Jim: Gall me picky, but I’d still like to list it all out... 


I. Create 
Wes) 

% Create ^ 3 

fcav ^ 


he tab bav ^ ^ ^ 

It :二二一 w 

W Ca?W IV, a ^ ar^d a 
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tab bars and core data 


tKereiare no ^ 

Dumb Questions 


Why are we using a tab bar controller and a table 

view? 

Our Fugitive data is hierarchical and lends itself well to a 
table view. The problem is, we have two table views: the Fugitive 
list and the Captured list. To support two top-level lists, we chose 
a tab bar. 

Couldn’t you have done something similar with a 
toggle switch, like a UlSegmentControl? 

Yes, we could have. It’s really a Ul design choice. The two 
lists are really different lists, not just different ways of sorting or 
organizing the same data. It's subjective, though. 

OK ， I’m still a bit confused about the business with 
using just one nib for the tab controller and the two table 
views. 


Well, there is a lot going on in this app, and we could have 
done this a different way. We could create two more nibs, each 
with a Nav Controller and a table view in it. Then we’d tell the 
Tab Bar Controller to load the first one as the Fugitive List and 
the second one as the Captured List. Rather than do that, since 
the views look the same, we just put all those controls for the list 
in the same nib as the tab bar. Remember, the nib is just the Ul 
controls, not the behavior. 

Can you use a tab bar controller for the iPad, too? 

Yup, but you might not need them. With the Split View 
Controller (which we’ll be using), you can display both a list and 
some details on the same screen, so you may be able to handle 
your data filtering with other elements. 



Create a new class for the Fugitive view controller in Xcode, 
and then add your tab bar controller in Interface Builder. 



Create one new class with .m and .h. files. 

These will be the view controllers for the Fugitive List and the 
Captured List. We’ll start with FugitiveListViewGontroller.h 
and .m for now，which needs to be a subclass of 
UITableViewG ontroller, so select 4 c UITable Vie wG ontroller 
subclass” from the drop-down in the Utilities pane. 



Add the tab bar controller. 

In Interface Builder, open the MainWindow—iPhone.xib to get 
started, and drop the tab bar controller in the view. 
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exercise solution 



Create a new class for the Fugitive view controller in Xcode, 
and then add your tab bar controller in Interface Builder. 


Create one new class with .m and .h files. 
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tab bars and core data 



Add the tab bar controller. 

The window template doesn’t give us a whole lot out of the box. We’re going to use Xcode 
to assemble our views and view controllers the way we want them. 




hounryHunrrr M.iinWlndowjPhonr.)(lh 


^ [ IhouniyHunT^r ( ■ | 


\A/Wi\c 

\s ^ 
should delete 

vt. 



Drag the tab bar controller from the Library into your main window listing. This will 
create your Tab Controller view. 

[j iBountyHunter - MainWindowJPhone.xib 


Si … 針 • ■ 


■ 目 ■□| 0 | 歷 _ 匯口 ___ _ 


◄ ► 」 iBountyHunter .* i 


MainWindowJPhone.xib (English) %m Tab Bar Controller 


® Placeholders 

( : . File's Owner 


^ First Responder 


Q Objects 




4 h 
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► o View Controller - Item 1 

► o View Controller - Item 2 

T\\t tab bav- 
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a tab ba\r a^i 
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Orientation Portrait 
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building the fugitive view 


Puild the fugitive list view 


We’re going to focus on the Fugitive List first, but the same steps will apply to 
the Captured List when we get to it. 



Delete those two view controllers and replace them with Navigation Controllers. 

Since we want all the functionality that comes with a Nav Controller, delete those View Controllers 
and drag two new Nav Controllers in their place from the Library. Make sure they’re listed 
underneath the tab bar controller. 




Change the view controller to the FugitiveListView controller. 

Highlight the view controller under the first Navigation Controller and use the inspector in the utility 
panel to change the Class to FugitiveListViewGontroller. 


Q 
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tab bars and core data 



Set the names in the tabbar and navbar. 

To change the title for the Fugitive List view controller, double-click on the title in the nav bar and 
type “Fugitives”. For the tab, in the Utilities pane, change the Bar Item Title to “Fugitives”. 


Updated Coht\rollcV" 
"title is wi-fcli -the 

badge item. 


_ iBounty... ) 


0 Placeholders 

File’s Owner 
First Responder 

^0 Objects 

H App Delegate 
Window 

W Tab Bar Controller 
Tab Bar 

Navigation Controller - Fu^ ^es 
Navigation Bar 

Fugitive List View Controller - Fugitives 

孤 If 

Navigation Controller - Item 




\>o^ 



We see the warnings. 

Yes, there are a couple in there. Don’t worry, 
we’re going to fix them soon. If you want to 
figure out what they are, it wouldn’t hurt! 
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checking things of your list 

Next up: the Captured view 

You’ve just gone through and created the classes for your two table views and 
dropped in a tab controller to switch between the two. You’ve already checked 
quite a few things off your list! 


Jus*t do -the same 
•thmj v/C did cav-|ic\r 
y/i*th Fugitives 
viev/ -fo\r -these •two 


Rcmcmbcv *tK*lS -fvom *thc 
doy>vc\rsa*tiov> cav-licv? 



p 。 Ust 




alor\^ … 七 h 
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代 W 以 “㈣ j 气 
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some 6odc 3hd IB 
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tab bars and core data 



BE 

Your job is to he tire developer and finish up tire 
worl^ in Xcode and Interface Builder to ^et tire 
Fugitive and Captured views worl^in^ wiSitiie 
^ tab bar controller. Use lie To Do 
t list from Jim, Frank, and Joe to 
figure out fiat’s left. 


It’s up to you to create tke 
capturect view anct tken connect 
tke views up witk tke tat tar 
controller... 
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be the solution 



BE th^ Dev^ei §©]iig©ti 

Your job is to he tire developer and finish up 
tire wort in Xcode and Interface Builder to 
贫 et tire Fugitive and C^tured views wording. 


Create your Captured view. 

Follow the same steps from earlier for 
creating the Fugitive view. 


__ Objects 

P App Delegate 
Window 

^ Tab Bar Controller 
Tib Bar 

^ Navigation Controller - Fugitives 


msi 


Navigation Bar 


Q| Fugitive List View Controller - Fugitives 
禱 Navigation Item - Fugitives 
a Tab Bar Item - Fugitives 
Navigation Controller - Captured 
Navigation Bar 

Captured List View Con fro Her - Captured 
Navigation Item - Captured 


You should Cr>d uf 
Wrth a lis 七 

looks like -this. 


Item - Captured 


Then wire up the tab bar controller. 

To do this, we need to go back to 
IBountyHunterAppDelegate_iPhone.h. Right now, there isn’t 
an outlet to connect the tab bar controller to anything, so it 
won’t work. You should be pretty familiar with how to do this 
by now. Here’s the outlet you need for a tab controller: 




iBountyHunterAppDelegateJPhone.h 



Almost tltere … 
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tab bars and core data 





Wert) well t\tt& *to Wire up *tKc Aff 
Delegate *to -the Tab Bav Cor>*tv-ollcv. 


0 Placeholders 


File's Owner 
Q First Responder 



Q Objects 


Add Delegate 


Window 
， u Tab Bar Contrj 
■ Tab Bar 
黔春 Navigation I 
鱉參 Navigation 
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Referencing Outlets 


delegate 篝 File’s Owne 
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o 


iBountyHunterAppDelegateJPhone.m 


Clear up the warnings. 

The UITableViewGontroller in XGode 4 comes with the 
numberOfSectionsInTableView: and numberOfRowsInSection: methods 
declared with #warnings so you don’t forget to set them up. 



Make suv-c Y ou delete 
Imcs. 


- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView 
// Return the number of sections . ；[ s 




return 


- (NSInteger)tableView:(UITableView *)tableView \umberOfRowsInSection:(NSInteger)section 
{ 

// Return the number of rows in the section 4 
return 0 ; ^ ___ _ 一 


FugitiveListViewController.m CapturedListViewController.m 


you are here ► 


387 









































test drive 




TesT DriVq 


You’ve just done a lot of work on your app—new view controllers, new Nav Controllers, table 
views—all from scratch. Build and run to make sure that everything’s working. 



CWk ad 州 akc sure that ， 

i\,t iPWe S\mulat>v sclented 

m )<todc, so 'Pad docs^i lau^ 


•ms*tead. 
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Ugflt! Votking! Witty isn’t tire tal> Lar 












tab bars and core data 


Sharpen your pencil 


Figure out why all you see is an empty view. Look at what we did earlier in Interface 
Builder (shown below) and see if you can figure out what’s missing. Write what you 
think on the lines below. 


The window template doesn’t give us a whole lot out of the box. We’re going to use 
Xcode to assemble our views and view controllers the way we want them. 


\aV)d > s 

v 
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no dumb questions 


tJiereiare no ^ 

Dumb Questi9ns 


We have a lot jammed in our main 
window nib. It still seems kinda strange 
to me. 

The nib for iBountyHunter contains five 
controllers (the tab bar, two Nav Controllers, 
and our FugitiveListViewController and 
CapturedListViewController) and their 
associated components. If you're still 
having trouble with the idea, it might help 
to open the MainWindow.xib file in Interface 
Builder and view it in tree mode. Expanding 
the hierarchy shows the structure of our 
app. We have a single nib with a tab bar 
controller, which internally has two Nav 
Controllers nested underneath it that are 
instances of FugitiveListViewController and 
CapturedListViewController, respectively. 

Can I add icons to the tab bar tabs? 

Absolutely. The easiest way is to pick 
a standard icon using Interface Builder. To 
do that, click on the question mark icon on 


the tab you want to change, then change 
the Identifier in the Inspector. If you want 
to use a custom image, set the Identifier to 
custom, then select your image in the Image 
field (you’ll need to add it to your project, just 
like we did with the application icon earlier). 
There are a couple of peculiarities with Tab 
Bar icons, though: they should be 30x30, 
and the alpha values in the icon are used to 
actually create the image. You can’t specify 
colors or anything like that. 

How many views can I have in a 
tabbar? 

As many as you want. If you add 
more views than can fit across the tab bar 
at the bottom, the UlTabBarController will 
automatically add a “More” item and show 
the rest in a table view. By default, the 
UlTabBarController also includes an Edit 
button that lets the user edit which tabs are 
on the bottom bar. 

Is there any way of knowing when a 
user switches tabs? 


Yes, there's a UlTabBarDelegate 
protocol you can conform to and set as the 
tab bar delegate. You’ll be notified when the 
users are customizing the bottom bar and 
when they change tabs. 

Why did we add a reference to the 
tab bar controller in the App Delegate? 

We’ve added the tab bar controller to 
the nib, but there’s a little more tweaking 
we’re going to have to do to get everything 
displaying properly. Go ahead and give it a 
Test Drive to see what’s going on... 


BULLET POINTS 一 

■ As apps get more complex, building 
the Ul becomes more difficult. 

■ The hierarchy view for the xib files 
helps visualize how the components 
go together. 


■ Separating the iPhone and iPad Ills 
is important, but the logic needs to 
remain consistent. 
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tab bars and core data 


^Sharpen your pencil 

Solution 


Figure out why all you see is an empty view. Look at what we did earlier in Interface 
Builder (shown below) and see if you can figure out what’s missing. Write what you 
think on the lines below. 


The window template doesn’t give us a whole lot out of the box. We’re going to use 
Xcode to assemble our views and view controllers the way we want them. 


teuATyHurvter 


nib 


n o it e ■ 
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My Universal App on iPhone 


Drag the tab bar controller from the Library into your main window listing. This will 
create your TabController view. 


iiL 
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a view within a view 


A view's contents arc actually subviews 

All the UI components we’ve used are subclasses of UlView. By dropping them into a 
view, we’ve made them subviews of some bigger container view. We need to do the 
same thing with our tab bar. We just need to go back into the GUI and add one more 
link between the main view and the Tab Bar Controller. 




Tesr DriVq 


Link up the rootViewController outlet to the Tab Bar Controller. Then everything should be 
working! Interface Builder knows how to work with tableviews and Nav Controllers, so the 
datasource and delegate will be automatically handled. 


iBountyHynter > [ iBou... > Q iPhone ^ = Main... ) MainWindowJPhone.xib (Etrglish) > Window 
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tab bars and core data 



TesT DriVq 


It’s time to see everything working. Build and run and 
you can see both tab views working with tables. 



Captured 




Fugitives 


Fugitives 


Captured 





Looks good! So now we 
need to get some data in 
those tables, right? 


you are here ► 
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time for some data 


After a quick meeting with fob". 



Here's my list of fugitives to 
track. While the court is in the 
process of going digital, I still 
only have this on paper. 


Managing Bob’s data is 
the next step. 



>o h ： 


^ d cvi , c 




Now that the iPhone app is up 
and running, you need to fill 
in the blanks. The list is pretty 
simple right now, so we can make 
the data into any form we want 


and then import it. 
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tab bars and core data 



Frank: I was thinking — I’m not sure a plist is such a good idea 
this time. 

Jim: Why not? We used it for DrinkMixer, and it worked fine. 

Frank: Well, this list could get pretty big — remember, the list of 
fugitives is going to be ongoing: the ones that Bob is trying to catch 
and those that he already has. 

Joe: So? 

Frank: So...a big list means lots of memory. 

Joe: Oh, that’s right — and the plist loaded everything every time. 
Frank: Exactly. 

Jim: What about that Gore Data thing, that’s supposed to handle 
large amounts of data, right? 

Frank: That was a new data framework introduced in iOS 3.0. 
That would probably work. 

Jim: Why use that and not just a database? Doesn’t iPhone have 
SQLite support? 

Frank: It does, but I’m not a SQL expert, and Gore Data can 
support all kinds of data, including SQL, but you don’t have to talk 
SQL directly. 

Joe: I thought you said we weren’t using SQLite? 

Frank: We are, but we’ll use Gore Data to access it. 

Joe: How does that work? 

Frank: Core Data handles all the dirty work for us — we just need 
to tell it what data we want to load and save... 





What are some other limitations with how we stored 
data in plists and dictionaries with DrinkMixer? 


you are here ► 
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building a data factory 


Core Pata lets you focus oh your app 


Loading and saving data, particularly lots of data, is a major part (often 
a painful one) of most applications. We’ve already spent a lot of time 
working with plists and moving objects in and out of arrays. But what 
if you wanted to sort that data in a bunch of different ways, or only 
see fugitives worth more than SI,000,000, or handle 100,000 fugitives? 
Writing code to handle that kind of persistence gets really old, really 
quickly. Enter Core Data... 



Ua,,cd Ehtitics) look like. 


㈡ 


M wait there's more! 


Gore Data makes loading and saving your data a snap, but it 
doesn’t stop there. It’s a mature framework that Apple brought 
over from Mac OS X to iOS in version 3.0 and gives you: 




The ability to load and save your objects 

Core Data automatically loads and saves your objects based 
on Entity descriptions. It can even handle relationships 
between objects, migrating between versions of your data, 
required and optional fields, and field validation. 




Different ways to store your data 

Core Data hides how your data is actually stored from 
your application. You could read and write to a SQLite 
database or a custom binary file by simply telling Core 
Data how you want it to save your stuff. 

Memory management with undo and redo 

Core Data can be extremely efficient about managing 
objects in memory and tracking changes to objects. 

You can use it for undo and redo, paging through huge 
databases of information, and more. 



database o\r simple b“y 


But teiore we do any ol 
tkat, we need to tell Core 
Data al>out our otjects.** 
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tab bars and core data 


Core Pata needs to know what to load 


We need Core Data to load and save the fugitive information that we 
need to populate our detailed view. If you think back to DrinkMixer, 
we used dictionaries to hold our drink information and accessed them 
with keys, like this: 


nameTextField.text = [drink objectForKey : NAME_KEY]; 
ingredientsTextView.text = [drink objectForKey:INGREDIENTS 一 KEY] 
directionsTextView.text = [drink objectForKey : DIRECTIONS KEY]; 



The problem with dictionaries and plists was that we had to store 
all our data by using basic types and get to this data with dictionary 
keys. We could have easily had a bug if we put the wrong type in the 
Dictionary or used the wrong key, causing lots of problems down 
the road. What we really want is to use normal Objective-G classes 
and objects where we can declare properties for the fields, use real 
data types, etc. You know, stuff you’re already really good at. That’s 
exactly what Gore Data lets us do. 

TV^csc are 

use ^ ^ W 

tlass m ObjcttWc -C* 



pvmkM • 说 v used 、 

(Jiv'mk • 丨 wfovwat ，。 卜 I 七 
^ovkcd, wt v/as ^tibl 

yvWrtWc. 


VJt use 
Co\rc Data -to 
populate this. 




Fuji-bi 


vc 


NSS"bv*ihj 决灼 aw 

NSDcdimal Numbcv- bounty 
•m 七 -fugitiveIP 


NSS*bv-*m^ 




P»dt»o^av'«cs v/ovked 

pymkMkev, W 七 

OVldc dl 


Aot!i ?v*ov«dc avW 
kmd o“7?e sa^et/ 
OV c^6a^ulat«o^ ok 

ouv data- T>mc w 
sowbWmS betbd.. 




Core pata v/ovks Wrbh 
W 必 ad 厂一必 
-to 5 'wc US {)r\t 00 
从 w av ' 七 . 


Wc need to define our types 

Not only can Core Data give us the OO-based 
view of our data that we want, it can even define 
our data graphically. There’s one snag though — 
out of the box, Gore Data supports a specific set 
of data types, so we need to define our entity using 
the types it offers... 


you are here ► 
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managed object model 


Core Pata describes entities with a 
Managed Object Model 

Entities controlled by Core Data are called Managed Objects. The 
way you deal with your entity descriptions (properties, relationships, type 
information, etc.) for Gore Data is through a Managed Object Model. 
Gore Data looks at that Managed Object Model at runtime to figure 
out how to load and save data from its persistent store (e.g., a database). 
The Xcode template we used comes with an empty Managed Object 
Model to get us started. Let’s take a closer look. 












« ^ ^ 




iftnunt^Hufil^r iSnunEyl a iijnl4 i r.i[B4LiCiimiHii , ] 


The tcr^pla-tc j s sc ^ 

U P So Co^t Vaia 
^11 i^ry h> load all 
the Magged 0\>\tci 
Models dc-Pihcd ih y ou ^ 
^ppli^a-tioh ai s-tav-tup 
咖 。— eed - 二 


IB^DuntvHyntcir 
1 qargei, ^ & 0 K 4 .^ 
ifanirMy'Hunl-r 

u n 时 r ju r ■ h 

pCourw^HunisrAjipDvk^ue.nn 

i #hiinc 

h ibpunf-ifHunBrr b^gailr^iffSfirv h 
m iB*tjnf^4unief ■ 甸穿 am 'fnoM.-Ti 
g4 Vj nW-XlO^ iPT ■ 心 on 办 

h lU^rUwLilGVlCW^WllMiQllCiJl 
Fugalivvl i^MnvCpnli^fllfVv^Ti 
h iviVif^-cHuriillfr.h 

醑 (^ap^uredlJiTVkwCoMr'rtkr.m 

....... •FJd 

h ilraurrt^WuniawA^f^pi^ijrlpJ^Jril.hi 
hi iBAtinr^Huner-r f»fljnf_.PjdJT , 

▼ ^ Fyiu 

ibtmrTtytwn 1 llpng 

I Nhj n 57 ■ pflfl 

厂 [iVountv«MynCtr-qnfO-^t 

RnlfcfluLiSnn^ 
h iKpuntyHunCfr-lftppftK.p^h 
:!» nuin.m 
— Ffijwwplci 


iMifflYHuftifP IBAuniyHunwf iBAtinF^yner-r 


择：十二二 匕‘； ^ 

4 。你 hd •心诎 is 灿 

_/^ 'l 

EOiM^oiyia^) 

BBS 


CONHCU RATIONS 


AHiflujin, 
MLinbulx 


.Krdam iBoi^nivHu^iTf.udAiirr.ade'l IMd KrtffEbCifl j 

Quick Mm\p 




^^SESB 


^ Ri ； U 1 iafHmp 4 
Rtlitiofiiliip- 




bw«m 


Fetched PTDp^rlifi 
I Propni^fy 


□ ? : O 


㊇ 帅 


Jj SB ^ 


0^1 睛 Add Ffltiiv 


O 


E3 -Vi 

FdiEnf SiV<f 


■o 国戀 

I ig| ifiSl I 

^si i_j 

H S PJ S 

® OO 參 

IB 


®sa © 




i t 


the Fugitive Ch 说 y . 



T“W 』 7 , 7 0 “孙 巧”七 C a j 
make *rb easier. 


Let’s go akeact and create our Fugitive entity … 
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tab bars and core data 


Puild your Fugitive entity 


We need to create a Fugitive entity in our Managed Object Model. 

Since our Fugitive doesn’t have any relationships to other classes, we 
just need to add properties. Open up iBountyHunter.xcdatamodeld 
to create the Fugitive data type. 

o To add the Fugitive entity, click the “plus” button ❺ 
all the way down here at the bottom of the 
window and change the name to “Fugitive”. 


Once the entity exists, you can 
add attributes to the data model, 
using this plus button here. 




IT ® 必 EEE » P 

iBountyHunterAppDelegate.h 
iBountyHunterAppDelegate.m 

iBountyHunter...legateJPhone.h 
[mj iBountyHunter...legate 」 Phone.m 
MainWindowJPhone.xib 
lh FugitiveUstViewController.h 
[m] FugitiveUstViewController.m 
! _h' Captu red Li stVi e wControl le r. h 
[m{ CapturedListViewController.m 

▼ fiB 屮 2 ^ 

[hj iBou ntyH u nterAppDelegate_i Pad.h 
[mj i Bou ntyH u n ter." Del eg ate J Pad .m 
^ MainWindowJPad.xib 

▼ Qj Supporting Files 

ibountyiconll4.png 
ibountyicon72.png 
ibountyicon57.png 
Qj iBountyHunter-Info.plist 
I nfo PI i st. strings 
h iBountyHunter-Prefix.pch 
[mj main.m 

^Frameworks ^ ^dd ^ 

Ll Products 


— iBountyHunter - iBountyHunter.xcdatamodel 


!J| ◄ ► I — iBountyHunter > CZ iBountyH... [[^'i Bou ntyH... > [ ^iBountyH. Fugitive Q bounty 


CD 


m 


DOS 


ENTITIES 

圓 

FETCH REQUESTS 

CONFICURA1 
@ Default 


▼ Attributes 
Attribute 


Attribute 


Type 






▼ Relationships 


■Relationship ▲ Destination In vers 

e 



+ - | 




▼ Fetched Properties 


晒 Fetched Property ▲ Predicate / 

/ 

+ ^j_ L 




o 


entities, you 
。七 hevs licvc 
W\{\\ *thciv* 


ultiflc 
M see 
boo, 3loir>^ 
V*cla*tlOir>sK*ips. 


Use these fields to edit the name 
and type of the property. You 
should use your normal property 
naming convention when naming 
these. 


Name bounty 
Properties Q Transient 
—:Indexed 


Optional 


Attribute Type Decimal 
Validation 



'S' 


Min 


Max 

0.00 


Default 


Advanced Q Index in Spotlight 

— Store in External Record File 


User Info 


Key 


Value 


Versioning 


Hash Modifier 
Renaming ID 


Attribute Sync 


Synchronization Disabled 


□ {}«»« 


~ - UDJ-t 


File Template Library 




O, 

Add Entit 


®a 0 


Outline : 

H l|^ Q* 土 \ t /BountyHunter 


h 




Objective-C protocol - An 
Objective-C protocol 

Objective-C test case class - An 
Objectrve-C class containing an 
OCUnit test case with a header 


Add Attribute Editor Style 









Gee} BifS 




You can change the Editor Style to a tree diagram style 
view. 


you are here ► 
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no dumb questions 


tJiereiare no ^ 

Dumb Questi9ns 


Why did you use an 

NSDecimalNumber for the bounty? Why 
not a float or a double? 

We’re going to store a currency value 
in the bounty field, so we want precision 
with the decimal part of the figure. Floats 
and Doubles are approximations, so you 
tend to get things like $9.999999998 
instead of $10.00 when using them for 
currency calculations. Our choice of 
NSDecimalNumber for the bounty has 
nothing to do with Core Data and everything 
to do with what we’re trying to store. 

What are the Transient and Indexed 
checkboxes for in Xcode when you create 
properties? 

The Transient checkbox indicates 
that Core Data doesn’t need to load or 
save that property. Transient properties are 
typically used to hold values that you only 
waint to calculate once for performance or 
convenience reasons, but can be calculated 
based on the other data you save in the 
Entity. If you use transient properties, you 
typically implement a method named 
awakeFromFetch: that is called right 
after Core Data loads your Entity. In that 
method, you can calculate the values of your 
transient properties and set them. 

The Indexed checkbox tells Core Data it 
should try to create an index on that property. 
Core Data can use indexes to speed 


up searching for items, so if you have a 
property that you use to look up your entities 
(customer IDs, account numbers, etc.), you 
can ask Core Data to index them for faster 
searching. Indexes take up space and can 
slow down inserting new data into the store, 
so only use them when they can actually 
improve search performance. 

I’ve seen constants declared with 
a "k” in front of them. Are they different 
somehow? 

Nope. It’s just a naming convention. C 
and C++ programmers tend to use all caps, 
while Apple tends to use the lowercase “k” 
instead. 

What if I need to use a type that 
Core Data doesn’t support? 

The easiest way is obviously to try 
to make your data work with one of the 
built-in types. If that doesn’t work, you create 
custom types and implement methods to 
help Core Data load and save those values. 
Finally, you could stick your data into a 
binary type (binary data or BLOB) and write 
some code to encode and decode it at 
runtime. 

What other types of persistence 
does Core Data support? 

Core Data supports three types of 
persistence stores on the iPhone: Binary 
files, SQLite DBs, and in-memory. The 


SQLite store is the most useful and what 
we’re using for iBountyHunter. It’s also the 
default. Binary files are nice because they’re 
atomic, meaning that either everything is 
successfully stored at once, or nothing is. 
The problem with them is that in order to be 
atomic, the iPhone has to read and write 
the whole file whenever something changes. 
They’re not used too often on the iPhone. 
The in-memory persistence store is a type of 
store that isn’t actually ever saved on disk, 
but lets you use all the searching, sorting, 
and undo-redo capabilities that Core Data 
offers with data you keep in-memory. 

What SQL datatypes/table 
structures does Core Data use when it 
writes to a SQLite database? 

The short answer is you don’t need to 
know. Even though it’s writing to a SQLite 
database, the format, types, and structures 
are not part of the public API and could 
potentially be changed by Apple. You’re 
supposed to treat the SQLite database as 
a blackbox and only access it through Core 
Data. 

So this is a nice GUI and all, but 
I still don’t see what this gets us over 
dictionaries. It seems like a lot of work. 

We had to tell Core Data what kind 
of information we’re working with. Now that 
we’ve done that, we can start putting it to 
work. 



Make sure your object model matches ours exactly! 

When you 1 re writing your own apps，there are lots of ways to set 
up your data model, but since we’re going to give you a database 
for iBountyHunter, your model must match ours exactly! 
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tab bars and core data 


MANAGED OBJECT MODEL CONSTRUCTION 


if 




Finish building the Fugitive entity in the Managed Object Model based on the 
Fugitive information we want to store. Remember, Core Data Types won't match our 
Objective-C types exactly. Make sure you name your properties the same as we have 
in the Fugitive diagram shown below. 




you are here ► 
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construction solution 


MANAGED OBJECT MODEL CONSTRUCTION SOLUTION 


// 




Finish building the Fugitive entity in the Managed Object Model based on the Fugitive 
information we want to store. Remember, Core Data Types won't match our Objective-C types 
exactly. Make sure you name your properties the same as we used in the Fugitive diagram. 

Make su^rc “ofticwal” 
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tab bars and core data 


C<sre Data XJp C]<sse - 

Core Pata is about managing objects 

So far we’ve talked about how to describe our objects 
to Core Data, but not how we’re actually going to do 
anything with them. In order to do that, we need to take 
a quick look inside Core Data. 

Inside Core Data is a stack of three critical pieces: 
the Managed Object Context, the Persistent Store 
Coordinator, and the Persistent Object Store. 



is 

^ Coit/t 


^ iht 
it.. 


..如 “ 4 does^i h3v c ^ 


Managed Object Context 
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1 Persistent Store V 
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delegating your data duties 



So, if we want to load or save anything using 
Core Data, we need to talk to the Managed 
Object Context, right? 



Exactly! 

But, the next question is how do we get data in 
and out of it? 

The Xcode template we used set up the Gore 
Data stack for us, but we still need to figure out 
how to talk to the Managed Object Context. 
Given what you know about Gore Data so far, 
how would you go about asking the framework to 
load and save data for you? 



Use SQLite commands. 






Write custom save and load code to update the data. 


rw,s v,as w ? 十 1 

aid tW»s kmd dode. 

Use Core Data to generate classes to do the work for you. , c , 丨 n .. sc 0 uv 

^ ㈣ Sr 二 r s 

sa — -从 wed k ask ’ 七 . 
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tab bars and core data 


i^|^rpen your pencil 


o 


❺ 


o 


Xcode can create a Fugitive class from our Managed Object 
Model that we can use like any other class. Follow the steps 
below to create the Fugitive class you need. 


Select the i Bounty Hunter. xcdatamode I and click on the 
Fugitive Entity. 

You need to have a Core Data entity selected before you ask Xcode to 
generate a class for you. 


Create a new Managed Object Class. 

Select File^New^New File. There will be a new type of file that 
you can add, the NSManaged Object Class. Select this file and click 

Next. 


After confirming the save location for the new file (iBountyHunter should 
be the Group)... 


Generate the .h and .m files. 

Click Create and you should have a Fugitive.h and a Fugitive.m added 
to your project. Go ahead and drag these up to the / Supporting Files 
group. 


you are here ► 
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sharpen solution 


Sharpen your pencil 
v Solution 


Xcode can create a Fugitive class from our Managed Object 
Model that we can use like any other class. 



Select the iBountyHunter 
.xcdatamodel and click on the 
Fugitive Entity. 

You need to have a Gore Data entity 
selected before you ask Xcode to 
generate a class for you. 




Create a new Managed Object 
Class... 

Select File~ > New~^New File. There will 
be a new type of file that you can add, the 

NSManaged Object Class. Select this 
file and click Next. 

After confirming the save location for the 
new file (iBountyHunter should be the 

Group)... 



Choose a template for your new file: 


Cfrc&a T4W(h 
C iwl C++ 
Usicp Imccrfjti 




ReMxrrte 
totfc Signing 
OLSicr 


Mnr 

C&CM 


； sumc you sdcd 


Now whch you d\rcatc a 
匕 0 為 Class, you should 

have sv\ optioh -fco dv-catc a 


Objcd Class. 



Generate the .h and .m files. 

Click Create and you should have 
Fugitive.h and a Fugitive.m added to 
your project. Go ahead and drag these 

up to the / Supporting Files group. 



I nfo Pi i st. strings 
f i Bou ntyhl iin te r-Pre fi x ,pch 


main. in 


Fugitive 上 
i Fugitive.m 
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tab bars and core data 


Your generated Fugitive class matches the 
Managed Object Model 

Xcode created two new files from our Fugitive entity: a Fugitive.h 
header file and a Fugitive.m implementation file. Open up both files 
and let’s take a look at what was created. 


Object 


Fugitive 


a 


#import <CoreData/CoreData.h> 


@interface Fugitive : NSManagedObj ect 



w Attributes 

bounty 

diesc 

fygilivelD 

name 


Relationships 


Qproperty (nonatomic, retain) NSDecimalNumber * bounty; 
Qproperty (nonatomic, retain) NSString * name; 

Qproperty (nonatomic, retain) NSString * desc; 

Qproperty (nonatomic, retain) NSNumber * fugitivelD; 




丁工以 :㉗ 

如 dlass?!?! 


Fugitive.h 


TV^ Oe Pa*ta 切? w seized ouv 


NSManagedObject handles storage and 
memory for generated properties 

The generated Fugitive class has properties for name, description, etc., but no fields 
in the class. The Gore Data framework (and NSManagedObject in particular) are 
responsible for handling the memory associated with those properties. You can 
override this if you want, but in most cases, this does exactly what you need. 


Tkingfs get even 
more interesting 
in Fugfitive.m … 
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that’s pretty handy 


There's no code in there either... 
but rm guessing that Tm not going 
to need to worry about that? 



Right! The Core Data 
framework takes care of it. 

The Fugitive.m class is nearly empty, 
and instead of synthesizing the 
properties, they’re declared with a 
new directive, @dynamic. 


#import ''Fugitive • h 〃 

@implementation Fugitive 

Qdynamic bounty; 

@dynamic name; 

@dynamic desc; 

Qdynamic fugitivelD; 


@end 




Fugitive.m 


TV^c •，— ewcwta 七， 0 灼 

J? i\\t tlass 

,s almost 60 — 邮 

㈣ 切！ 
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tab bars and core data 


NSManagedObject also implements the properties 

The new @dynamic directive tells the compiler not to worry about the getter 
and setter methods necessary for the properties. They need to come from 
somewhere, though, or else code is going to crash at runtime when something 
tries to access those properties. This is where NSManagedObject steps in 
again. Because NSManagedObject handles the memory for the fields backing 
the properties, it also provides runtime implementations for the getter and 
setter methods. By having NSManagedObject implement those methods, you 
get a number of other neat benefits: 




The NSManagedObject knows when properties are 
changed, can validate new data, and can notify other 
classes when changes happen. 


NSManagedObject can be lazy about fetching 
property information until someone asks for it. For 
example, it does this with relationships to other 
objects. 


NSManagedObject can keep track of changes to 
properties and provide undo-redo support. 






How do you think you’ll get Core Data to load a 
Fugitive from the persistent store? 


Y<>u get all <^P 
"this without 
v/\ri-tihg a I'me o-f 
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NSFetchRequests 


Use an NSFetchRequest to 
describe your search 


In order to tell the Managed Object Context what we’re 
looking for, we need to create an NSFetchRequest. The 
NSFetchRequest describes what kind of objects we want 
to fetch, any conditions we want when it fetches them (like 
bounty > S 1,000), and how Core Data should sort the results 



Ask the Managed Object Context to fetch 
data using your NSFctchRcqucst 

All that’s left is to ask the Managed Object Context to 
actually execute your NSFetchRequest. That means we’ll 
need a reference to a Managed Object Context. Fortunately, 
the template set one up for us in the App Delegate. We can 
get to it like this: 




Ewtity Iwfo 


Predicate 


You provde a 

七 tcmdvbo ⑽ 

栋 c cities must 州 cct 

•，- f you Y/a 士 d — ⑼七七 

*tV>c Ictbe’ 

g. Wc 娜七 all, so 

^redita 七 c 



Sort descriptor 



丁 sort 

Ore ^ 

data He 

t 匕 tt 糾♦一 


iBountyHunterAppDelegate *appDelegate = 

(iBountyHunterAppDelegate*)[[UIApplication sharedApplication] delegate]; 
NSManagedObj ectContext *managedObjectContext = 
appDelegate.managedObjectContext; 
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tab bars and core data 


NSFetchRequest *request = [[NSFetchRequest alloc] init]; 

NSEntityDescription *entity = [NSEntityDescription 
entityForName : @"Fugitive" inManagedObjectContext : managedObjectContext] 
[request setEntity: enti 沙 ⑽ ^ ^ 

ky 咖 c, a F— 七 Wc. 

NSSortDescriptor *sortDescriptor = [[NSSortDescriptor alloc] 
initWithKey:@-name- ascending: YES] ; $ - 〜 ^ 

sorted al^abc-t^allv 


NSArray *sortDescriptors = [[NSArray alloc] 
initWithObjects:sortDescriptor, nil]; 

[request setSortDescriptors : sortDescriptors]; 

[sortDescriptors release]; 

[sortDescriptor release]; 

NSError *error; 

NSMutableArray *mutableFetchResuits = [[managedObj ectContext 
executeFetchRequest : request error : &error] mutableCopy]; 

if (mutableFetchResuits == nil) { 

// Might want to do something more serious.•• 

NSLog (@ A, Can f t load the Fugitive data!"); 


self.items = mutableFetchResults; 
[mutableFetchResults release] 广 - 1 '^ 
[request release]; 


/\|| bo ask ouv 

{jo yve us \>acM \rcsul-b m 

dy\d uf ouv vc*fcv-cir\dcs. 



Where do we put all this code? And where 
are we going to store the results? What about 
actually displaying the fetched data? 


you are here ► 


411 





brain barbell solution 







Where do we put all this code? And where 
are we going to store the results? What about 
actually displaying the fetched data? 


Sihdc Bob is bo *bo see Kis lis-b ds sooy\ ds Kis view shows up, 

Code heeds *bo go m*to vicw^ill/\ppcav* *m Fu^i*tivcLis*t\/icwCoh*tv"olIev-.m. 

As -for s*bo\r'm^ *the \rcsul*U, well yt badk array, bu*t wc release i 七 v-igh-t away. IVc 
r\ccd *to keep d vc-fcrchdc to array *m our view dorrbrollev. 

\y\ ordev *to dd*budlly show *this dd*bd ； weVc ^o*m^ *to Y\ttA *to n^plemerrt *the 
dellFov-Roy//\*t|r\de%Pa*th -to pull {he da*boi -from {ht array. 


The next two exercises togefier will get you all ihe 
code you need to view ihe fetched data properly... 


^Jharpen your pencil 


Let’s get all of these pieces into the app. 



Create the mutable array to hold the fetched items. 

Create an array in the FugitiveListViewGontroller called items to hold the 
results of the fetch. Don’t forget to synthesize the property and clean up memory. 



Import the appropriate headers into FugitiveListViewController.m. 

Make sure that you #import headers for the App Delegate and the Fugitive 
classes into FugitiveListViewController.m. 



Implement the fetch code inside viewWillAppear. 

Take what we learned on the previous couple of pages and get the fetch working. 
You’ll need to get the Managed Object Context from the delegate, create the fetch, 
and then execute it. Remember to update the code to actually hang onto the results 
by assigning them to the array we just created. 
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tab bars and core data 



Tatle Cell Magnets 

Use the code snippets below to customize the table 
cells for the fugitive list. 


- (NSInteger)numberOfSectionlnTableView:(UITableView *)tableView { 
return 1; 


// Customize the number of rows in the table view. 

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection: 
(NSInteger)section { 


// Customize the appearance of table view cells. 

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtlndexPath: 
(NSIndexPath *)indexPath { 

static NSString *CellIdentifier = @ 〃 Cell 〃； 


UITableViewCell *cell = [tableView dequeueReusableCellWithldentifier: 
Cellldentifier]; 

if (cell == nil) { 

cell = [[[UITableViewCell alloc] initWithStyle : 

UITableViewCellStyleDefault reuseldentifier:Cellldentifier 

autorelease]; 
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sharpen solution 


cc^harpen your pencil_ 

Solution 

It’s a lot of code to implement, but when you’re done. Core Data 
will be fetching the data you need for the fugitive list. 



Create the mutable array to hold the fetched items. 


#import <UIKit/UIKit•h> 

Qinterface FugitiveListViewController : UITableViewController { 


NSMutableArray *iterns ; 


Qproperty(nonatomic , retain) NSMutableArray *iterns; 

@end 




FugitiveListViewController.h 


Import the appropriate headers into 
FugitiveListViewController.m. 



#import ''FugitiveListViewController. h 

#import ''iBountyHunterAppDelegate . h 
#import ''Fugitive .h 〃 

@implementation FugitiveListViewController 

@synthesize items=iterns ; 



- (void)dealloc 


FugitiveListViewController.m 
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tab bars and core data 



Implement the fetch code inside viewWillAppear. 


- (void) viewWillAppear : (BOOL)animated { 

[super viewWillAppear:animated]; 

iBountyHunterAppDelegate *appDelegate = (iBountyHunterAppDelegate*) 

[[UIApplication sharedApplication] delegate]; 

NSManagedObj ectContext *managedObjectContext = appDelegate. 
managedObjectContext; 

NSFetchRequest *request = [[NSFetchRequest alloc] init]; 

NSEntityDescription *entity = [NSEntityDescription 
entityForName : @"Fugitive" inManagedObjectContext : managedObjectContext]; 

[request setEntity:entity]; 

NSSortDescriptor *sortDescriptor = [NSSortDescriptor 
sortDescriptorWithKey : @"name" ascending:YES]; 

[request setSortDescriptors : [NSArray arrayWithObject:sortDescriptor]] 

NSError *error; 

NSMutableArray *mutableFetchResults = [[managedObjectContext 
executeFetchRequest : request error : &error] mutableCopy]; 

if (mutableFetchResults == nil) { 

// Handle the error; 


self.items = mutableFetchResults 
[mutableFetchResults release]; 
[request release]; 


m 


FugitiveListViewController.m 
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magnets solution 



TaWe Cell Magnets Solution 

Use the code snippets below to customize the table 
cells for the fugitive list. 

#pragma mark Table view data source | 


- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView { 
return 1; 

} 

// Customize the number of rows in the table view. 

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection: 
(NSInteger)section { 



// Customize the appearance of table view cells. 

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtlndexPath: 
(NSIndexPath *)indexPath { 

static NSString *CellIdentifier = @ 〃 Cell 〃； 


UITableViewCell *cell = [tableView dequeueReusableCellWithldentifier: 
Cellldentifier]; 

if (cell == nil) { 

cell = [[[UITableViewCell alloc] initWithStyle : 
UITableViewCellStyleDefault reuseldentifier:Cellldentifier] autorelease]; 

} ttevVs Cove Pa*ta a*t v/ov-k. TKc data is stov-cd ^ovmal 

ObjCd*tivc-C Fu^rtivc objedts. No move did*tiohavy 

keys hcvc- 


// Configure the cell... 


Fugitive *fugitive 


[items objectAtIndex : indexPath.row]; 


cell•textLabel.text 


cell.accessoryType 


return cell 


fugitive.name; 


UITableViewCellAccessoryDisclosurelndicator; 


+ fMs! 



To completely wire up your table view, in Interface Builder make 
sure that the table view in the Fugitive List has its datasource as the 
FugitiveListViewController. 
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tab bars and core data 



Very cool. Let’s grab the data. 


Browse over to http:/ / www.headfirstlabs 
•com/books/iphonedev and download 
iBountyHunter.sqlite. In XGode, right- 
click on your iBountyHunter project and 
select “Add Files to iBountyHunter” 
and make sure it is copied into the 
project’s / Supporting Files directory. 

As you do that, think about what this 
means for your app. Will adding in a new 
database mean a bunch of refactoring, or 
can Core Data help out here, too? 



Pob's database is a resource 



We have all this code already in place to load data — it came 
with the Gore Data template. But how do we get from there to 
actually loading the database? 


MV hdhdlcd the obj^t 
the /Wdhagcd 

Cohtcxi a^d the Fugitive 


Class. 


look a 七 
lAfe wed 
{p Co 代 Pata 

ouv F— 七 wc Pa-tabasc. 
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databases are resources 


Pack to the Core Pata stack 

Remember the Gore Data stack we talked about earlier? We’ve gotten 
everything in place with the Managed Object Context, and now we’re 
interested in where the data is actually coming from. Just like with the 
Managed Object Context, the template set up the rest of the stack for us. 



leave i\\t Coov-dma*tov- as is. 


so >wC 乙 3 扒 


TV>c ,s ^ 

。於 vcspo^blc U a^ually ^adm 3 

d^a 妊 c w data. Tha 七 s 

从 v\ttd *to look. 
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Let’s take a look at wkat tke template 
set up lor us in tke App Delegate... 







tab bars and core data 


The template sets things up for a SQLitc PP 

The Gore Data template set up the Persistent Store Coordinator to use a 
SQLite database named after our project. As long as the database is named 
iBountyHunter.sqlite, then Gore Data should be ready to go. 


- (NSPersistentStoreCoordinator ^)persistentStoreCoordinator 

{ 

( persistentStoreCoordinator != nil) 


return persistentStoreCoordinator; 


碑 & 

e 如 as y 财 p 卞 t 


NSURL *storeURL = [[self applicationDocumentsDirector^ URLByAppending 
PathComponent:@"iBountyHunter•sqlite"]; ^_ 

NSError *error = nil; 

_persistentStoreCoordinator = [[NSPersistentStoreCoordinator alloc] 

initWithManagedObjectModel : [self managedObjectModel]]; 

if (![_persistentStoreCoordinator addPersistentstoreWithType : NSSQLite 

StoreType configuration : nil URL : storeURL options : nil error : terror]) 

{ 

NSLog(©^Unresolved error %@, %@", error, [error userlnfo])/ 

abort(); TV,e W ? latc ^ adds a 

} She 伤如 too^abor ^ the 

return persistentStoreCoordinator; 

iBountyHunterAppDelegate.m 



Tost DriVq 


Now that the database is in place and the Persistent Object 
Store can be used as-is, go ahead and run the app. 
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test drive solution 




TesT DriVq 



Wkere is tke ctata? 



We added the database to the project. 
The code looks right. This all worked with 
DrinkMixer. Whafs the deal?? 


Core Data is looking somewhere else. 

Our problem is with how Gore Data looks for the 
database. Well, it’s actually a little more complicated 
than that. 
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tab bars and core data 


iOS Apps are read^owjy 


Back in DrinkMixer, we loaded our application data from a plist by 
using the application bundle. This worked great and our data loaded 
without a problem. But remember how we talked about how this 
would only work in the simulator? It’s time to sort that out. As part of 
iOS security, applications are installed on the device as read-only. You 
can access any resources bundled with your application, but you can’t 
modify them. The Gore Data template assumes you’re going to want 
to read and write to your database, so it doesn’t even bother checking 
the application bundle. It checks the application documents directory 


instead. 


Vatci iff 


. 



iBountyHunterAppDelegate.m 


Let’s take a closer look at kow 
tkose ctirectories are set up … 
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iOS app structure 


The iPhone's application structure defines 
where you can read and write 


For security and stability reasons, iOS locks down the filesystem pretty 
tight. When an application is installed, the iOS creates a directory under 
/User/Applications on the device using a unique identifier. The 
application is installed into that directory, and a standard directory 


structure is created for the app. 


□ 


romc 





□ 

□ 


iBouirrtyttuirrte\r.ap¥ 
Dodumerrts 


Libv-av-y 


■» 






Caches i 


a ? —aW ㈣•• 易 d 一 '二 
IP _IP) ad 如 a?? 

a,W 仏狄 ”11 sW ^e ： TVus 

\rcad -一 仏 e a 代 ,6a IO 〜 

Uc Potum^ts LikarY d^Wicsa^ 
vcad-^-tc -for i\\t a^d also backed 

up by .Tunes y/V^^ usev S^US tViciv dcvidc. 

TVis is wV^crc user data y^ccds -to 30. 

TV bathes AWttboYs/ lasts most o( the 

bclwcch lauhdhcs ahd though 

updates, but you heed "to be able "to 
vc^catc ii siw it iW 七 backed uf... 


V 


□ 


七你 p 



TV 七州？細 W/ IS 'rcad-^-tc -too, 
Wt ^ ba^cd 




Use the Pocuments directory to store user data 

Since most Gore Data applications want to read and write data, the template sets up our Gore Data stack to read 
and write from the Documents directory. An application can figure out where its local directories are by using the 
NSSearchPathForDirectorieslnDomains, just like the template does in the App Delegate: 

- (NSURL *)applicationDocumentsDirectory 

{ 

return [[[NSFileManager defaultManager] URLsForDirectory : NSDocumentDirectory 

inDomains : NSUserDomainMask] lastObj ect]; 
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tab bars and core data 


Copy the database to the Pocumewts directory 

When the application first starts, we need to check to see if there’s a copy of the 
database in our Documents directory. If there is, we don’t want to mess with it. If 
not, we need to copy one there. 


■ tW 


roiA 


|| *to dtcUrt tWis 

method m 
SV^av-cd^. 


- (void)createEditableCopyOfDatabaselfNeeded { 

// First, test for existence - we don't want to wipe out a user's DB 

NSFileManager *fileManager = [NSFileManager defaultManager]; 

NSURL *documentsDir = [self applicationDocumentsDirectory]; 

NSURL *writableDBPath = [documentsDir URLByAppendingPathComponent:@〃iBoun 
tyHunter.sqlite"]; 

BOOL dbexists = [fileManager fileExistsAtPath : writableDBPath]; 

if (!dbexists) { 

// The writable database does not exist, so copy the default to the 

appropriate location. 

NSURL *defaultDBPath = [[[NSBundle mainBundle] 

URLForResource : @"iBountyHunter" withExtension : @"sqlite"]; 

Hcvc, WC yab master Vd ^ ouv 
NSError *error; bwdle; is v-cad-o^ly 

BOOL success = [fileManager copyltemAtURL : defaultDBPath 
toURL : writableDBPath error : &error] ; ^ 1 七 心 0 w v-cad-o^ly 

if (! success) { ^ - 仏 c Vrtablc 細如 ”. 

NSAssertl(0, @〃Failed to create writable database file with message 
k %@ f , [error localizedDescription]); 


- (BOOL)application : (UIApplication *)application didFinishLaunchi 
ngWithOptions : (NSDictionary *)launchOptions jBoui 

// Override point for customization after application launch. 
[self createEditableCopyOfDatabaseIfNeeded]; 

[self.window makeKeyAndVisible]; 
return YES; 


HunterAppDelegate.m 


you are here ► 


423 






that’s a lot of perps 



You need to uninstall the old version of your app from the 
simulator. 

This deletes the empty database that Core Data created earlier. When you 
build and run again, your new code will copy the correct DB into place. 



Tesr DriVq 


Now that the app knows where to find the 
database, it should load. 
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tab bars and core data 


Why didn’t we have to do all of 
this directory stuff with the plist in 
DrinkMixer? 

We only ran DrinkMixer in the 
simulator, and the simulator doesn’t enforce 
the directory permissions like the real device 
does. We’d basically have the same problem 
with DrinkMixer on a device. The reason this 
was so obvious with iBountyHunter is that 
Core Data is configured to look in the correct 
place for a writable database, namely the 
application’s Documents directory. 

How do I get paths to the other 
application directories? 

Just use NSSearchPathForDirectories 
InDomains but with different NSSearch 
PathDirectory constants. Most of them you 
won’t ever need; NSDocumentsDirectory is 
the most common. You should never assume 
you know what the directory structure is 
or how to navigate it—always look up the 
specific directory you want. 

So what happens to the data when 
someone uninstalls my application? 

When an application is removed from 
a device, the entire application directory is 
removed, so data, caches, preferences, etc., 
are all deleted. 



Q/ The whole Predicate thing with 
NSFetchRequest seems pretty important. 
Are we going to talk about that any more? 

Yes! Well come back to that in Chapter 9. 

So is there always just one 
Managed Object Context in an 
application? 

No, there can be multiple if you want 
them. For most apps, one is sufficient, 
but if you want to separate a set of edits 
or migrate data from one data source to 
another, you can create and configure as 
many Managed Object Contexts as you 
need. 

I don’t really see the benefit of the 
Persistent Store Coordinator. What does 
it do? 

Our application only uses one 
Persistent Object Store, but Core Data 
supports multiple stores. For example, you 
could have a customer's information coming 
from one database but product information 
coming from another. You can configure two 
separate persistent object stores and let the 
persistent store coordinator sort out which 
one is used based on the database attached. 


How about object models? Can we 
have more than one of those? 

Yup—in fact, we're going to take a look 
at that in Chapter 9, too. 

Do I always have to get my 
NSManagedObjects from the Managed 
Object Context? What if I want to create a 
new one? 

No, new ones have to be added 
to the context—however, you can’t just 
alloc and init them. You need to create 
them from their entity description, like this: 
[NSEntityDescription insertNewObjectFor 
EntityForName:@’’Fugitive” inManaged 
ObjectContext:managedObjectContext]. 

That will return a new Fugitive instance and 
after that you can use it like normal. 
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building the detail view 



Now we need to build the 
detail view, right? 


Exactly. 


We have the database loading with 
detailed information, but the user can’t 
see it yet. Now, we just need to build out 
the detail view to display that information 
as well. 


YouVc dlmos 七 Aor\t 
youv lis 七 , 




夕 /W you 


kr>oy/ how *fco d 
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tab bars and core data 



ExeRclSe 


Building the detail view isn’t anything new for you—so get to it! Here is 
what you’re working with from our earlier sketch for the detail view. 

Create a new view controller and nib called the FugitiveDetailViewGontroller. 
Lay out the nib using Interface Builder to have the fields we need. 


□ 


Then update the new view controller to have outlets for the fields we’ll need to set and a 
reference to the Fugitive it’s displaying. 





t 卜 ,ID, Bou，U 

sii ^r iy va,uc su,d 


TWis area ^ (or y\oics and 
de-tails akou-t 


㈣ 尸七 " sU,d 

U ' Tcxi ^ That 

= V ， — 


Carrier ^ 


PM 


ru^i-tivc Name 

Fugitive IV^ 


Bouh 七 y: 


TV^C detail U tacM 如 11 

fee arable tkk 中以吖 Mmc. 


AH ^ fields sWld be ^ad- 

— smte v/C (Wt 心七 uSCyrS 
bouses. 


TV\c value *bV^c 
bou^Y Will fee V^cvc. 
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long exercise solution 



jtPHg ExedctSe 
SoLutiort 


Go through and check the code, outlets, 
declarations, and dealloc. 


The files that you need for the new view are: FugitiveDetailViewController.h, 
FugitiveDetailViewController.m, and FugitiveDetailViewController.xib. 


To create them, just select File^New File and create a UlViewController file 
and check the box that says “With XIB for User Interface.” After that, you’ll 
need to move the .xib file into /iPhone directory within Xcode. 


« o o 
® ▼④ 


LJ iBountyHunter - FugitiveDetailViewController.h 


iBountyHunter | iPhone 4. 


imk lvj 


CD 


回 



11 ® 厶 » p 

III! ^ 

■III ^ 

一 i. > 

h) FugitiveDetailViewController.h @interface FugitiveDetailViewController 

D 



iBountyHunter 

1—J 1 target, iOS SDK 4.3 

iBountyHunter 

h iBountyHunterAppOelegate.h 
iBountyHunterAppDelegate.m 
[jjj iBountyHunter.xcdatamodeld 
▼ Cj iPhone 

h iBountyHunter...legateJPhone.h 
|mj iBountyHunter ..legateJPhone.m 
MainWindowJPhone.xib 
[hj FugitiveUstViewController.h 
|m| FugitiveUstViewController.m 
[h] CapturedListViewController.h 
[mj CapturedListViewController.m 

hQ 


// 

If 

// 

// 

// 

// 

// 


FugitiveDetailViewController.h 
iBountyHunter 

Created by Tracey Pilone on 3/26/11. 

Copyright 2011 Element 84, LLC. All rights reserved. 


#import <UIKit/UIKit.h> 


@interface FugitiveDetailViewController : UlViewController { 

} 

I 

@end 


[m| FugitiveDetailViewController.m 

FugitiveDetaiJViewController.xib 
▼Cl] iPad 

[hj i Bou n ty H u n te rAp p De I eg ate_i Pad. h 
[m| iBountyHunter...DelegateJPad.m 
/v Mai n Wi ndowj Pad .xib 
Supporting Files 

ibountyiconll4.png 
ibountyicon72.png 
ibountyicon57.png 
f I iBountyHunter-Info.plist 
[j InfoPlist.strings 
[hj iBountyHunter-Prefix.pch 
fe] main.m 
Fugitive.h 
[mj Fugitive.m 

iBountyHunter.sqlite 
► Q Frameworks 
Products 


you dmcatc the hew dass -Piles, you II have 
uKc -rh ； 3hd ->cib -piles. 


▼ Quick Help 

FugitiveD€tailViewController : 
UlViewController 

Name: UlViewController 
Availability: iOS (2.0 and later) 

Abstract: The UlViewController class provides 
the fundamental view-management model 
for iPhone applications. The basic view 
controller class supports the presentation of 
an associated view, support for managing 
modal views, and support for rotating views 
in response to device orientation changes. 
Subclasses such as UINavigationController 
and UlTabBarController provide additional 
behavior for managing complex hierarchies 
of view controllers and views. 

Declared In: UlViewController.h 

Reference: UlViewController Class 
Reference 

Related Documents: View Controller 
Programming Guide for iOS 

Sample Code: AdvancedURLConnections, 
ListAdder, NavBar, UlCatalog, 
i PhoneCore DataRecipes 


D U 菇 ■ 


I |JJ File Template Library 


h 


©OH © 




II 


^ i i I iBountyHunter 


Objective-C protocol 

Objective-C protocol 


Objective-C test case class - An 
Objectrve-C class containing an 
OCUnit test case with a header 
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tab bars and core data 


@interface FugitiveDetailViewController 

©private 

Fugitive *fugitive—; 

UILabel *nameLabel_; 

UILabel *idLabel_; 

UITextView *descriptionTextView 
UILabel *bountyLabel ; 


UlViewController 






FugitiveDetailViewController.h 


©property (nonatomic, retain) 
©property (nonatomic, retain) 
©property (nonatomic, retain) 
©property (nonatomic, retain) 
©property (nonatomic, retain) 
@end 


Fugitive *fugitive; 

IBOutlet UILabel *nameLabel; 

IBOutlet UILabel *idLabel; 

IBOutlet UITextView *descriptionTextView 
IBOutlet UILabel *bountyLabel; 


@implementation FugitiveDetailViewController 

@synthesize fugitive=fugitive_; 

@synthesize nameLabel=nameLabel_; 

@synthesize idLabel=idLabel_; 

@synthesize descriptionTextView=descriptionTextView 
@synthesize bountyLabel=bountyLabel ; 





- (void)dealloc 
{ 

[fugitive 一 release]; 

[nameLabel 一 release]; 

[idLabel 一 release]; 

[descriptionTextView_ release] 
[bountyLabel— release]; 

[super dealloc]; 


c> 


m 



FugitiveDetailViewController.m 
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long exercise solution 



ExefictSe 
SoLutloH 


Now build the view in Interface Builder. 

S*tav-*t ou*t by all m -the v-i^lvt spots, ar\d 30 

loddk ar\d dus-bomizjC 

To -the simulated havigatioh ba^ ih 
the Utilities Rahd, set the Top Bav -to 
Waviga*tioh Bav- W . 


TV^sc arc \>oi^ 
labels, but 
七 k U d 七 ^ 
IP # *to 12- ft. 


丁 he Tcxtl/icw heeds 
"to be upsized io 

Z 切 x us'm 9 

"the ihsped-tov-. 



七 / 1S a sc ? ayra ^ C 

label i\\t value. 



Lorem ipsum dolor sit er elit 
lamet, consectetaur cillium 
adipisicing pecu, sed do 
eiusmod tempor incididunt ut 
labore et dolore magna 

j\Wn\\7\ I It pnim aH minim 

Label « Label 


▼ SimulateaMetrics 

Orientatior Portrait 


Status Bar\Cr^iy 


Top Bar Navigation Bar 


Bottom Bar None 


▼ View 


Mode Scale To Fill 
Alpha 


1.00 


Background 


Tag 0 Q 

Drawing 0 Opaque C Hidden 
Clears Graphics Context 
□ Clip Subviews 


D U ^ H 


lJ Objects 


3 



12 


Text 


0 





Si s 







Use msfc^-tov- -to default 

values o-P o-P *b^csc clcw\c^*bs *to 

% 9 *,t，vc T— 七 We |P’’,eU. 
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tab bars and core data 














Wtrts *tV^c -f'mal I'istmj o-f domfo\r\cr\*b 
Jc detail view. 


I iPhone 4.3 S... : 



_ iBountyHunter - FugitiveDetailViewController.xib 


隊 

Running iBountyHunter on iPhone Simulator 

l 1 

No Issues 


Make suv-c *b^at 
all *bV^c added 

clcwcv\*bs 3v*c 

tWildvcv' o*f 

mam 



Owner 


File ， 


®®®®o® o o 
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geek bits 



Ul Gee} Bits - 

We're going to add some spit and polish to this view. It's fine the way it is, but here’s 
some iPhone coolness to add. 


Fugitive Name 




f[dd a \rouy\dcd 

buuXO^) 

-tof <Jc 

ICY/- 


c 


Lorem ipsum dolor sit er el it 
lamet, consectetaur cillium 
adipisicing pecu, sed do 
eiusmod temper incididunt ut 


We’ll make this button function as a border. To do that, you need to do 
two things: 

o In the element listing for the view, move the button above the Text View. This will 
move the button behind the text. 

❺ With the button still selected, use the Utilities pane to uncheck the enabled box 
(under the Attributes panel). 
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tab bars and core data 


9^. 

ExeaciSe 


Now, populate the detail view from the Fugitive List. 
You know how to do this from what we did earlier with 
DrinkMixer. 


o 

You should be able *to 
-f igure ou*t OTit- 


The other files need to know that the detail view exists. 

implementation file, you’ll need to # import F ugitiveD e tail Vie wG ontroller. h. 




The detail view needs to be displayed. 

In that same implementation file, the table view needs some selection 
code. It’ll be similar to the code that we used in DrinkMixer. 



The fields need to be populated with the data. 

The detail view code needs to populate the existing fields with the data 
from the fields that were set up with the Fugitive.h and Fugitive.m 
classes and the Core Data code. In viewWillAppear: 



TVicsc av-c jus*t a 

o-f bu*t should 

you all 

you’ll 


fugitiveNameLabel.text 
fugitiveldLabel•text = 


=fugitive.name; 

[fugitive.fugitiveID 


stringValue]; 
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populate the detail view 




HctSe 

lytiOH 


Now, populate the detail view. You know enough 
from before to do this. 



The other files need to know that the 
detail view exists. 


Just add tw.s -to 

Pucx»t»vcUst\/*«CY/Co^ollcv.m A-.lc. 

❺ 


In some implementation file, you’ll need to 
#import F ugitiveDetailViewGontroller.h 


The detail view needs to be displayed. 

In that same implementation file, the table view 
needs some selection code. It’ll be similar to the 
code that we used in DrinkMixer. 


#pragma mark - Table view delegate 

- (void)tableView:(UITableView *)tableView didSelectRowAtlndexPath:(NSIndexPath 
*)indexPath 


FugitiveDetailViewController *detailViewController = 

[[FugitiveDetailViewController alloc] initWithNibName:@〃FugitiveDetailV 
iewController 〃 bundle:nil]; 


detailViewController.fugitive 




row]; 


[items— objectAtlndex : indexPath. 

_ < 2 - 


[self.navigationController pushViewController : detailViewController 
animated:YES]; 

[detailViewController release] ; ^ \/ lCY/ Con*bvollcv-" 


should d’s ㈣. 


FugitiveListViewController.m 
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tab bars and core data 


o The fields need to be populated with the data 


#import ''FugitiveDetailViewController. h y 


@implementation FugitiveDetailViewController 

Qsynthesize fugitive, fugitiveNameLabel, fugitiveldLabel, 
fugitiveDescriptionView, fugitiveBountyLabel; 

Addihft the s-t\r*mg\/aluc oh the 

- (void) viewWillAppear: (BOOL) animated { d o-f these two dcdlavatiohs 

handles the that they 赠 t 

^br^s, but WS/Vumbcv ahd 
NSPc^irwal/Vurhbcv-s. 

self.nameLabel.text = fugitive .name; 


[super viewWillAppear : animated]; 


self.idLabel.text = [fugitive 一 . fugitiveID stringValue 
self.descriptionTextView.text = fugitive—•desc; 
self.bountyLabel.text = [fugitive 一 .bounty stringValue]; 

} I 

FugitiveDetai 


m 


FugitiveDetailViewController.m 
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test drive 




Tqst DriVQ 


After populating the detail view, you can see 
the information about each fugitive. 


The badk bu-t-feo^ is wo\rkmg -thanks {jo 

the 匕 ojvbrol. 


Kow ah 

c +y Gh be 
s dcdcd ih -the 
view. 




Carrier ^ 12:12 PM 

Fugitives 

Ameilia Bones 

> 

David Adams 

> 

Emmanuel Uttenburg 

> 

Fiona Westin , 

George Palin 

> 

Henry Lewis 

> 

Hunter Sweeney 

> 

1. Stol eit 

> 


r . . - 1 


Fugitives 


Captured 




T\\t labels 
lidve bccr\ 
v-cflatcd 
values 
-fvom ■blic 
database. 


It all works! 
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tab bars and core data 


It works great! Having all that 
information with me makes it much 
easier to catch outlaws. I should be 
able to almost double my business 
with this app! 


Great! 

After a couple of weeks, Bob is back 
with a new request... 


That really worked! Ive 
caught a ton of people already! 
How can I keep track of who 
Ive caught? And when do I 
get the iPad app? 


To be 

continued.. 
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coredata cross 



CoreDafa cross 

There’s a lot of terminology with Core Data ； let’s 
make sure you remember it! 



Across 


Down 


2. Each app has a_directory. 

5. NS_Descriptor captures how data should be sorted. 

6. In the middle of the Core Data stack is the Persistent Store 


7. The_template is pretty basic. 

8. _can manage different types of data. 

10. The managed object_is the top of the Core 

Data stack. 

11. NSFetch_describes a search. 


1 ■ The Persistent Object Store is at the_of the 

Core Data stack. 

3. Core Data has_and redo. 

4. The_controller is good for switching views. 

9. The managed_model describes entities. 
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tab bars and core data 






畢 






Match each field we need to implement for the data view to its Gore 
Data type. 


Field for the Detail View 


Core Data Type 


Name 


Int32 



^2. bit ihtcgcv* 





String 


E<\uivalch-t -to 
/VSS-t\rih^ 
attv-ibutc 


Boolean 



A 300L value 
(YK ov KO) 


Description 


Decimal 



Date 
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who are you? 


A bunch of Core Data code in full costume are playing a party 
game, “Who am I?” They’ll give you a clue—you try to guess who 
they are based on what they say. Assume they always tell the 
truth about themselves. Fill in the blanks to the right to identify 
the attendees. 

Tonight’s attendees: Managed Object Model, 
NSManagedObject, Managed Object Context, NSFetchRequest, 
and NSSortDescriptor. 

Any of the charming items you’ve seen so far just might 
show up! 



^Vho 




Name 


Describes the search you want to execute on your data. 
Includes type of information you want back, any conditions 
the data must meet, and how the results should be sorted. 


Responsible for keeping track of managed objects active in the 
application. All your fetch and save requests go through this. 


Captures how data should be sorted in a generic way. You 
specify the field the data should be sorted by and how it 
should be sorted. 


Describes entities in your application, including type information, 
data constraints, and relationships between the entities. 

A Objective-G version of a Gore Data entity. Subclasses of this 
represent data you want to load and save through Gore Data. 
Provides the support for monitoring changes, lazy loading, and data 
validation. 
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tab bars and core data 



CoreData cross Solution 

So, did you remember all those words? 



Across 

2. Each app has a_directory. [DOCUMENTS] 

5. NS_Descriptor captures how data should be sorted. 

[SORT] 

6. In the middle of the Core Data stack is the Persistent Store 
_. [COORDINATOR] 

7. The_template is pretty basic. 

[WINDOWSBASED] 

8. _can manage different types of data. 

[COREDATA] 

10. The managed object_is the top of the Core 

Data stack. [CONTEXT] 

11. NSFetch_describes a search. [REQUEST] 


Down 

1. The Persistent Object Store is at the_of the 

Core Data stack. [BOTTOM] 

3. Core Data has_and redo. [UNDO] 

4. The_controller is good for switching views. 

[TABBAR] 

9. The managed_model describes entities 

[OBJECT] 
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who does what solution 








孓备亀轉 


Match each field we need to implement for the data view to its Gore 
Data type. 


Field for the Detail View 


Core Data Type 



Int32 



This will be 

v-cpircsch-tcd as av\ 

Ws/Vumbc\r ih Obj-C. 


String 


£<\uivalch-t -to 

/VS£-t\rih0 

^ttv-ibutc 


Boolean 



A BOOL value 
(Yt£ ov KO) 


Decimal 
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tab bars and core data 


A bunch of Core Data code in full costume are playing a party 
game, “Who am I?” They’ll give you a clue—you try to guess who 
they are based on what they say. Assume they always tell the 
truth about themselves. Fill in the blanks to the right to identify 
the attendees. 

Tonight’s attendees: Managed Object Model, 
NSManagedObject, Managed Object Context, NSFetchRequest, 
and NSSortDescriptor. 

Any of the charming items you’ve seen so far just might 
show up! 









Name 


Describes the search you want to execute on your data. 
Includes type of information you want back, any conditions 
the data must meet, and how the results should be sorted. 


NSpctdhRc'ucs 七 


Responsible for keeping track of managed objects active in the 
application. All your fetch and save requests go through this. 




Captures how data should be sorted in a generic way. You 
specify the field the data should be sorted by and how it 
should be sorted. 


hlQQoriVcsCr'i p-(x>\r 


Describes entities in your application, including type information, 
data constraints, and relationships between the entities. 


Manayd Model 


A Objective-G version of a Core Data entity. Subclasses of this 
represent data you want to load and save through Gore Data. 
Provides the support for monitoring changes, lazy loading, and data 
validation. 




oo 
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core data toolbox 



Your Core Pata Toolbox 

You’ve got Chapter 8 under 
your belt and now you’ve 
added Core Data to your 
toolbox. 


TaV> Bavs 

㈣ 妯 ♦ a sc?araU 



TV>c Paia Model 

lA/ov^ks y/i-tK entities i\\ai V>avc 
^V"O^CV"*tlCS ddllcd 3*t*tv*ibu*tcs. 

Can be edi-ted AWtd\^ m 々 ode. 

Has several di-f-fcv"c^*b da 七 a *t-7P cs * 


Cove Pa^ta 

Pvovidcs a s*t3dk *tV>a 七 ma^a^ cs 
da*b3 so you do^*t have *to. 

Cars ma 於 ay ty\>cs of 

da*ba. 

^V"C 3 *t *foV mCW'OV'Y m 3 ^ 3 ^C^Cv>*t 

a^d *tva£-k»^3 



BULLET POINTS - 

■ Core Data is a persistence framework that 
offers loading, saving, versioning and undo-redo. 

■ Core Data can be built on top of SQLite 
databases, binary files, or temporary memory. 

■ The Managed Object Model defines the Entities 

we’re going to ask Core Data to work with. 


■ The Managed Object Context is our entry point 
to our data. It keeps track of active Managed 
Objects. 

■ The Managed Object Context is part of the Core 
Data stack that handles reading and writing our 
data. 


444 Chapter 8 















9 mlgr^iting and optimising With Core Delta 


肴 

Things are changing 

參 





We have a great app in the works. 


iBountyHunter successfully loads the data Bob needs and lets him view the fugitives 


easily. But what about when the data has to change? Bob wants some new functionality, 


and what does that do to the data model? In this chapter, you’ll learn how to handle 
changes to your data model and how to take advantage of more Core Data features. 


this is a new chapter 
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bob wants to get paid 


Pob needs documentation 



Bob needs to record 
more information. 

Bob has to keep track of his 
work so he can be paid. That 
means we need somewhere 
to store the day and time of a 
capture and then use that to 
build the Captured view... 



-that 

CapWd view wc buili i h 
tnc Iasi 


How are we going to update 
iBountyHunter to kanctle tke 
new information? 
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migrating and optimizing with core data 


iJharpen your pencil 

We neec 


need to figure out how to update iBountyHunter 
to handle this new data. Look at each piece of our 
application and write what, if anything, needs to change. 





Where do we start? 
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start with the new data 



We need to figure out how to update iBountyHunter 
to handle this new data. Look at each piece of our 
application and write what, if anything, needs to change. 

- A spo*t *bo mark 
-fu^i-tivcs as 

一 Show dd*be dhd 
o-f daj>*tu\rc. 

一 Populate *the 

Captured list 




- Add a dap*tu\rcd -flaj 

*bo -fu^i*tivcs. 


一 Add 七 he dap*tu\rcd 
■time -fov 七 he -fu^i-tive. 


一 Add *thc dap*tu\red 
dd*be -for -the -fugitive. 



View Controllers 


- Pill m -the da*be ar\d 

dap*tu\rc data. 

一 Display ohly tKc 
dap*tu\rcd -fugitives *m 
■the Captured view. 



一 Add m-fo\rma*tioh 
dbou*b *tKc *bo 

■the da*ba -for display m 
ihc app. 


Where do we start? nearly cvcv-y-thmj depends oy \ *thc y \ c ^ da 七 3 

wc Y\ttd *to add ； let’s grt *tha*t m our object model 
-fiv-s*tj we C^y\ update *thc res-t- 
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migrating and optimizing with core data 


Everything stems from our 
object model 

So now you’ve figured out that the Fugitive entity needs a 
few more fields: the date and time, and something to indicate 
whether the fugitive has been captured. The database is built 
from the data model, so we can just update the data model 
to add the information we need. The Gore Data date type 
includes both a date and time, so we only need two more 
properties on our Fugitive entity: 


Sihdc dll -fugitives 
will be ci-tlicv 
^aptu\rcd o\r hot, 

it heeds -fco exist 

-Po\r dll o-p -them. 



This pv-ovidcs 
both the 
3hd the ti 


dcs _ 

daie 一 

I captdatel 

\ - Date I 



oh, y ^ ihe 

^diiiv CSj 

its op-tio h a|. 



Update the data model with the new captured fields. 


Use the data model editor to update the model with the two new fields. 


After you update the model, you’ll need to delete the two old fugitive 
class files and generate new ones with the new fields included. 
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your updated model 




EjcegctSe Use the tools that Xcode comes with to quickly make those changes. 

SOLutlOH 


/ 


Use the Data Model Editor to update the model with the two new fields. 


After you update the model, you’ll need to delete the two old fugitive 
class files and generate new ones with the new fields included. 



Make su\rc 七 youv 
a*t*tvibu*tcs 


ouvs. 



@interface Fugitive : NSManagedObject 
@private 


@property 

bounty; 

@property 

@property 

@property 

©property 

©property 

@end 


(nonatomic, retain) NSDecimalNumber * 


(nonatomic, 

(nonatomic, 

(nonatomic, 

(nonatomic, 

(nonatomic. 


retain) NSString * name; 
retain) NSNumber * fugitivelD 
retain) NSString * desc; 

retain) NSNumber * capture 
retain) NSDate * captdate 



TVicsc -f ields 
av-C 

elevated classes. 


Fugitive.h 
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migrating and optimizing with core data 



一 


#import ''Fugitive . h' 


@implementation Fugitive 
@dynamic bounty; 

@dynamic name; 

@dynamic fugitivelD; 

@dynamic desc; 

@dynamic captured; 

@dynamic captdate; 

@end 


Tqst DriVQ 




Fugitive.m 


■ 


TV^c mw fields V^avc 
added as d)^\c p\rofcvt»cs, 
ysi like cavlicv* cmes. 


Once you’ve made the changes, go ahead 
and run 旧 ountyHunter 



All Output t 


Clear 


■□ 關 [] 


<CFString 0xe268f0 [0xl00a400] 

<CFNumbe 


i ~~^uramurg~omiz'ijraruv~~ = nrar3nc\mnroxw~ / — 'tirannnTrgr 
】>{contents = "E711F65F-3C5A-48B9-872B-6541E4B2863A"} 

8 : <CFString Oxe26720 [Oxl0Oa4O0]>{contents = "NSStoreType" 

>{contents = "SQLite"} 

9 : <CFString Ox5al64f0 [0xl0Oa4OO]>{contents = "NSStoreModelVersionHashesVersion"} 
r 0x590b4a0 [OxlO0a4O0]>{value = +3, type = kCFNumberSInt32Type} 

10 : <CFString 0x5al65b0 [0xl09a409]>{contents = "_N5AutoVacuumLevel"> * <CFString 0x5al66b0 
0xl00a400]>{contents = M 2 M } 

} 

• reason=The model used to open the store is incompatible with the one used to create the store}, 

{ 

metadata = { 

NSPersistenceFrameworkVersion = 248; 

NSStoreModelVersionHashes = { 

Fugitive = <e33370b6 e7ca3101 f91d2595 Ie8bfe01 3e7fb4de 6ef2a31d 9e50237b b313d390>; 

}； 

NSStoreModelVersionHashesVersion = 3; 

NSStoreModelVersionldentifiers = ( 

)； 

NSStoreType * SQLite; 

NSStoreUUID = ••E711F65F-3C5A-4889-872B-6541E4B2863A"; 
n _NSAutoVacuumLevel n = 2; 

reason = "The model used to open the store isVincompatibl^Vith the one used to create the sto 




re. 


s^jncompatible^j 


sharedlibrary apply-load-rules all 

Current language: auto; currently objective-c 


w 


It craskect! Wkat ctict we miss? 
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data needs updating 


The data hasn't been updated 


If you take a close look at the console report of the crash, 
you can figure out what’s wrong... 


This c\r\rov- seems -feo be 
doming -Pvorw Cov-c Daia. 


I 七 ’s dornfld'm'm^ 七 ha 七 ouv- 
daia model dompatiblc 
y/1-t^ i\\t oy>C *tv>a*t d\rca*tcd 
the daiabase- 


丨 Clear 

xi_y VAjaiUJuu 


<CFString 0xe268f0 [0x1003400] 

=<CFNumbe 


All Output t 

i • ^jrwriiiy oa«7£uoiiv ivatx«fuoh«fv j luii ts ■ vmwrwmu / 

]>{contents = "E711F65F-3C5A-4889-872B-6541E4B2863A"} 

8 : <CFString 0xe26720 【 0xl00a400】>{contents = M NSStoreType M > 

>{contents = ••SQLite"} 

9 : <CFString 0x5al64f0 [Oxl00a400]>{contents - "NSStoreModelVersionHashesVersion 
r 0x590b4a0 [0xl00a40O]>{value = -f3, type = kCFNumberSInt32Type> 

10 : <CFString 0x5al65bO [0xl00a400]>{contents s NSAutoVacuumLevel"} = <CFString 0x5al66b0 
0xl0Oa400]>{contents = n 2 M } 

f reason=The model used to open the store is incompatible with the one used to create the store}, 
metadata = { 

NSPersistenceFrameworkVersion = 248; 

NSStoreModelVersionHashes = { 

Fugitive = <e33370b6 e7ca3101 f91d2595 Ie8bfe01 3e7fb4de 6ef2a31d 9e50237b b313d390>; 

>； 

NSStoreModelVersionHashesVersion = 3; 

NSStoreModelVersionIdentifiers s ( 

)； 

NSStoreType = SQLite; 

NSStoreUUID = __E711F65F-3C5A-4889-B72B-6541E4B2863A M ; 

M _NSAutoVacuumLevel M = 2; 




>； 

reason 


•The model used to open the store is incompatible with the one used to create the sto 


sharedlibrary apply-load-rules all 

Current language: auto; currently objective-c 




▼ 


FugiUve 



Fugitive 


T Attributes. 

bounty 

desc 

fugitivelD 

name 


Ouv* ovi^m^l F 

oy>ly had -fouv atbribu 七 《... 


The data model is different 
than what was used to actually 
write the data. 



T Attributes 
bounty 
captdate 
captured 
d esc 

fugitivelD 
fiame 

IRefatioriships 


iipr 


m 


Core Pata caught a mismatch between 
our PP and our model 


We created this problem when we added new fields to the 
Fugitive entity. Our initial fugitive database was created 
with the old model, and Gore Data has no idea where to 
get those new fields from. Rather than risk data corruption, 
it aborted our application with an error. That’s good, but 
we still need to figure out how to fix it. 
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migrating and optimizing with core data 


Pata migration is a common problem 

Realizing you need to add new data or changing the way you store old 
data is a pretty common problem in application development. But just 
because it’s common doesn’t mean it’s easy. Gore Data works hard to 
make sure it doesn’t corrupt or lose any data, so we’re going to have to 
tell it what to do with our new Fugitive entity. 


Fugitive 


Managed Object Context 



Persistent Store 
Coordinator 


■ 




▼ Attributes 

bounty 

captdate 

captured 

desc 

fugitivelD 


Ovav yvoWcw' 






Persistent Object Store 





Fugitive 




F Attributes, 
bounty 
desc 

fugitivelD 

name 


、加 Pevs. 如 t ，念 

- a ,d rc\aW^- 


▼ 


Relationships 



..bu 七七 he DB >was tvca*tcd Vrth *tV>c old Fuytivc 七 rty, 
so rt has 七 he old hash value. TKc pc\rsistcv>*t Objcd*t , 
S*tovc -fails *to load da*t3> say'm^ i*t *t load v/ha't s 
•m 七 ha 七 database *m*bo *tV>c entity. 





Right now, we have the old data and 
the new data model. How can we get 
the new data? 
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two data models 


Migrate the old data into the wew model 

We made the changes to the data model, but we need everything up and 
down the Gore Data stack to be able to deal with those changes. In order to 
do that, we need to migrate the data. 

To migrate anything, you need to go from somewhere to somewhere. Core 
Data needs to have both of these data models to make data migration work 
for the entire stack. We need a new approach to changing the data model, 
besides just changing the old one. Let’s undo what we did earlier so we can 
load the data from the database again. 


r 


DATA MODEL DEMOLITION 

In order for our data model to have a starting point 
and an ending point, we need to go back into 
iBountyHunter.xcdatamodel and remove the two 
new fields — for now. 

Delete 
these Z 

-fields. 

Then go back and check that it’s 
working again; you may need to 
delete it from the simulator first. It 
will save lots of time and trouble later. 


a 





Fugitive 


▼ Att rib ules 


bounty 


' captu red — 
desc 


fugitivelD 


name 


T Relationships 

J 




L 


J 


Our two models need different versions 

It’s easy enough to change the data model by hand, but Gore Data 
needs to be able to work with both the old and new data. We need to 
give Core Data access to both, but tell them they’re different versions 
of the same model. Even more importantly, we need to tell Core Data 
which one we consider our current version. 


TVis is what wc siaried 
'with, 3hd the Pcv-sis-tcht- 
SWc is 

this daia model. 


Old data model 
iBountyHunter .xcdatamodel 



The Pcvsistcht S-toy-c 

y>ccds khow "tliis is 
what wc dohsidev- OUV" 

vemsioh. 




Fugitive 

■ 



▼ Attributes 

bounty 

captdate 

captured 

desc 

fugilivelD 


1 


name 




T Relationships 

J 


New data model 
iBountyHunter 2.xcdatamodel 
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Xcode makes it easy to version your 
data model 


Fortunately, it’s pretty easy to create a new version of your data 
model using Xcode: 



Highlight iBountyHunter.xcdatamodeld. 

Then go to the Editor^Add Model Version menu option. That will generate 
a new file under the iBountyHunter.xcdatamodeld directory called iBountyHunter 
2.xcdatamodel. 



Set the current version. 

Highlight the iBountyHunter.xcmodeld directory, then select the File Inspector on the 
Utilities Pane. Then in the Versioned Data Model section, select “iBountyHunter 2” 


as the Current version. 




Update the new data model. 

Select iBountyHunter 2.xcdatamodel and re-edit the data model to add the captdate 
and captured fields back in as we did before. Now the old version is preserved and the 
changes are where they belong. 



foe} B 形 


Normally, you’d also need to delete and regenerate the 
Fugitive class, but since we made the same changes to 
the new file, the generated class would be the same. 


How does tke app 
map between tke 
two versions? 
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data migration 



Jim: Ugh. I guess we need to write a bunch of migration 
code or something. 

Joe: Why? 

Jim: I assume we’re going to have to tell Core Data how to 
get from the old version of the data to the new one, right? 

Frank: Well, actually, I think we can do it automatically. 

Jim: What? 

Frank: Gore Data has a feature that allows you to tell the 
app about both models and it can migrate the data for you. 

Jim: Nice! When does the data actually get migrated? 

Frank: Runtime, when the Persistent Object Store sees that 
the data is in the old format. That means that we’ll just need 
some code to tell iBountyHunter to actually do the migration. 

Joe: OK, so it looks like some of that code is auto-generated, 
and some of it needs to be added. 

Jim: This is great; so we can just change whatever we want? 

Frank: There are certain data changes that Gore Data 
can handle automatically, like adding new attributes. More 
complex changes to the data need to be handled manually. 

Joe: Yeah, it says here that we can do automatic migration if 
we’re adding attributes, or changing the optional status of an 
attribute. 

Jim: What about renaming? 

Frank: Renaming gets tricky — sometimes you can and 
sometimes you can’t. 

Joe: So, how can we migrate the data we have? 
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Core Pata caw "lightly" migrate data 


Lightweight data migration is a powerful Gore Data tool that allows you to cleanly update 
your underlying data to match a new data model without needing a mapping model. It only 
works with basic data changes: adding new attributes, changing a required attribute to an 
optional one, or making an optional attribute required with a default value. It can also handle 
limited renaming of attributes, but that gets trickier. 

Automatic data migration happens at runtime, which means that your app needs to know 
that it’s going to happen so that the data can be migrated. You’ll do that in the AppDelegate: 

- (NSPersistentStoreCoordinator *) persistentStoreCoordinator iBountyHunterAppDelegate.m 

{ Remember by a^ault Core Pata V»ll load all ， 

oW\tci models your ^ That .t will 

… o\A version du\r\rcy\*t version o\ 


if ( persistentStoreCoordinator != nil) 


return persistentStoreCoordinator; 


see both old version 
OIaV" W\odcl 


NSURL *storeURL = [[self applicationDocumentsDirectory] URLByAppendingPathComponent 
:@ 〃 iBountyHunter.sqlite〃]; 

NSError *error = nil; 

NSDictionary *options = [NSDictionary dictionaryWithObjectsAndKeys : [NSNurnb 
er numberWithBool : YES], NSMigratePersistentstoresAutomaticallvOption, [NSNumber 
numberWithBool : YES] , NSInferMappingModelAutomaticallyOption, >Tiil]; 

persistentStoreCoordinator = [[NSPersistentStoreCoordinator alloc] initWithManaged 


ObjectModel : [self managedObjectModel]]; 

if (![ persistentStoreCoordinator addPersistentStoreWithType : ^J^SQLiteStoreType 

/\|| y/e Y\ctd dob) enable 

is 七 u\nr\| 


configuration : nil URL : storeURL options : op^fLons error : &error]) 


NSLog (Q^Unresolved error %@, %@" r error, [error userlnfo] )，• 


abort 


i 七 


o 灼 . 




l/Ve 乙 "this -fvorw Wih options *to pass -the 

options b> "the pc\rsis-tc^tSWcCoovdia-tov*. 


Tost DriVq 


After adding the code to the app delegate, build and debug... 


you *m*to issues heve , 七巧 
Clean -fivs-t ； Build Debu’ 
SVa^yly, )< 6 odc docs^-t alv/ays 
v-cdomfilc A" 七七 “e 产败 siem youv 

model, but should it 
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test drive 




TesT DriVq 


mm 

■ carrier 亨 12:28 PM P| 


Fugitives 


Kate Raines 
Linda Lewis 
Michael Merkins 
Mike Smithson 
Mike Thayer 
N. Winner 
Nick Forsee 
Nicky Wolf 


> 

> 

> 

> 

> 

> 

> 

> 



Awesome! It’s working witk a 
wkole new ctata modeL 
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The Pcvsistciftt Object Stove 


This week’s interview: 
Do you really have any 
staying power? 


Head First ： Hi, Persistent Object Store, mind if I 
call you POS for short? 

Persistent Object Store: I d rather you didn’t. 
Just “Store” is fine. 

Head First ： OK, Store, so I understand you’re part 
of the Core Data stack? 

Store ： Yep — one of the most important parts, 
actually. It’s my job to read and write your actual 
data. 

Head First: Right, you’re the guy who translates 
into a bunch of different formats. 

Store ： Exactly. When you use Gore Data, you 
don’t really need to know if your data is going into a 
simple file or a sophisticated database. You just ask 
me to read and write a bunch of data and I handle it. 

Head First: That’s convenient. I understand you 
can be pretty particular, though. I hear you don’t 
take well to change. 

Store ： I don’t think you’re getting the whole picture. 
See, it’s my job to make sure your data is loaded and 
saved exactly right. 

Head First ： I get that, but still, small changes are 
OK, right? 

Store ： Sure 一 I just need to make sure you really 
want me to do them. You need to tell me what 
data I’m looking at and then tell me how you want 
me to return it to you. Tell me it’s OK to infer the 
differences and do the mapping and I’ll take care of 
the rest. 

Head First ： So do you actually migrate the data or 
just translate it when you load it? 


Store ： Oh, I actually migrate the data. Now, here’s 
where things get cool. Simple stores like the binary 
file ones just create a new file with the migrated data. 
But if I’m using a SQLite DB, I can usually do the 
migration right in place. Don’t need to load the data 
and the whole migration is nearly instant. 

Head First ： Nice! I thought lightweight migration 
was kind of a noob’s migration. 

Store: Oh no, if you can let me do the migration 
through lightweight migration, that’s definitely the 
way to go. Now if you need to do something more 
complicated, like split an old attribute into two new 
ones or change the type of something, you’ll need to 
help me out. 

Head First ： And people do that through code? 

Store ： Sort of. Basically, you need to give me one 
more model, a mapping model. That tells me how 
to move your data from the old format to the new 
format. 

Head First ： Hmm, OK, makes sense. I guess this 
applies to renaming variables too? 

Store ： Actually, most of the time I can handle that 
too, as long as you tell me what the old name was. If 
you look at the details of an attribute in your object 
model, you can give me the old name of an attribute. 
If it’s there, and I have to do a migration, I can 
handle renaming, too. 

Head First ： Wow, you’re not nearly as boring as I 
thought... 

Store ： Thanks, I guess. 


you are here ► 
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tJiereiare no ^ 

Dumb Questi9ns 


How many versions of a data model 
can I have? 

As many as you need. Once you start 
adding versions, you’ll need to keep track of 
your current version so that Managed Object 
Model knows what you want when you ask 
for an entity. By keeping all the old versions 
around, Core Data can migrate from any 
prior version to the current one. 

When is renaming something OK 
for a lightweight migration? When isn’t it? 

You can rename variables as long 
as you don’t change the type. If you 
rename them, click on the little wrench 
on the attribute properties in Xcode and 
specify the renaming identifier to be the old 
attribute. Core Data will handle the migration 
automatically from there. 

Can I use migration to get data 
I have in some other format into Core 
Data? 

No. Migration (lightweight or 
otherwise) only works with existing Core 


Data. If you have legacy data you want 
moved into Core Data, you'll need to do 
that yourself. Typically, you just read the 
legacy data with your own code, create a 
new NSManagedObject to hold it, populate 
the new object, and save it using Core 
Data. It’s not pretty, but it works. There are 
a couple other approaches you can look 
at if you have large amounts of data to 
migrate or streaming data (for example, from 
a network feed). Take a look at the Apple 
Documentation on Efficiently Importing Data 
with Core Data for more details. 

Does it make a difference if I use 
lightweight migration or migrate data 
myself? 

Use lightweight migration if you can. 

It won't work for all cases, but, if it can be 
done, Core Data can optimize the migration 
if you’re using a SQLite store. Migration 
time can be really, really small when done 
through lightweight migration. 

What do I do if I can’t use 
lightweight migration? 

You’ll need to create a mapping model. 
You can do that in Xcode by selecting 


Design^Mapping Model, then picking 
the two models you want to map between. 
You’ll need to select your source entities 
and attributes, then select the destination 
entities and attributes. You can enter custom 
expressions to do data conversions if you 
need to. To find out more information on 
mapping models, check out the Apple 
Documentation on Core Data Migration. 

Xcode lets me enter a hash 
modifier in the Versioning Settings for an 
attribute. What are those for? 

Core Data computes a hash for 
entities using attribute information so it can 
determine if the model has changed since 
the data store was created. However, it’s 
possible that you need to change the way 
your data is stored without actually changing 
the data model. For example, let’s say you 
always stored your time values in seconds, 
but then decided you needed to store 
milliseconds instead. You can continue to 
store the value as an integer but use the 
version hash modifier to let Core Data know 
that you want two models to be considered 
different versions and apply your migration 
code at runtime. 


(^^BUUET POINTS —— 

■ Lightweight automatic migration 
needs both versions of the data 
model before it will work. 

■ Automatic migration can change a 
SQLite database without loading the 
data. 


■ Migration of data happens at 

runtime. 

■ You can use lightweight migration 
to add variables, make a required 
variable optional, make an optional 
one required with default, and to do 
some renaming. 
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Here's what youVe done so far... 






What kind of changes do we need to make 
to the UI to add the captured information? 
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bob should keep his day job 

Pob has some design input 


I want all this captured info on the 
detail view. Here, I sketched up some 
ideas for you on how to do that. 



O 



一 

Cancel 




Fugitive Name 

Fugitive ID^ 

Lorem iipsum dolor sit er el it 
lamet，consectetaur cillium 
adipisicing pecu, sed do 
eiusmod temper incididunt ut 
labore et dolore rnagna 
aliqua. Ut enim ad minim 


f I was thinking 

veniam, quis nostrud 

Bounty: $1,000,000 

I could just type in Y 、 

( or N when I capture a J 

Captured? Y/N I I 

V guy? Then fill in the date j 


V and time below. y 

■ ——-- - - - ■ l 


Capture Date 1 
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But Bob’s sketek 
kas some problems •“ 



























migrating and optimizing with core data 


<l|iharpen your pencil 


Bob’s view needs some improving. As an experienced 
iOS developer, you can probably come up with some 
better Ul designs. Time for you to help him out. 


o 

❺ 


Gan Bob’s view actually work with the app as it’s currently written? (Circle one) Yes No 


If not, why not? 



To properly implement this view, you need to know what data is editable. What 
data can the user edit and what is the best way to handle that input? 



Sketch up your plan for the final detail view: 


Pon-t {哼七 

dbou*b Tab _ 

Coy\*tv-ollcv- Ao^y\ 



you are here ► 


463 























a better interface 


%Sharpen your pencil 

Solution 


Now that you’ve thought through the design implications, 
what should the detail view look like? 

o Gan Bob’s view actually work as is with the app as written? (Circle one) Yes No 


❺ 


o 


If not, why not? lAfe al> ： eady. have a. Wtipn wKcvc Bob wa^is. *tp pui a. 
bu*tioh. -the user *to mput ,*thc ^ ，1 o\ra^di -type . 七 .dstc dhd -time is hot 

. 

To properly implement this view, you need to know what data is editable. 

What data can the user edit and what is the best way to handle input? The ohly dd'bcj 


tKa*t will heed to is -the Cap-tuy-cd -field *t))c Captuyed date a^di 

Sihdc Captured is a boolea〜a swi*t^h o\r some k*md dorrbrol will work better 

七 yP!M. Bob will doht\rol y/hch he ^3p.*tu\rcs the bad y/c dah just 

七 .. 七 h?. dhd *ti.mc {vpp i(?S a^d sayc cych more *typm.5 ： 


o Sketch wp your plan for the final detail view: 


TVsc *Uo fields Will 
be labels, l»kc locW 


Pew’ 七 -fov-yb 
afeou*t *bV>c "Tab 

Coyrt^rollcv- dow V^C. 



\Mt ” ced 七 Wis 

一 Y/C’ll 


la 七 cv- 


see •• 


V^avc -to 


A segrwe^-ted dojvbrol will work 
jv-cat hc^rc- Thai will 你 … 

NO iypmj \rc^uiv-cd -to mpui 
七 he data. 


Label y/i*th da*tc f time m-fo- 
populated by -the -fvom 
y/hc^ *thc yes/ y\o is -tolled- 
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migrating and optimizing with core data 



Make the additions you need to the detail view 
to include the additional fields. 



Open up FugitiveDetailViewController.xib in Interface 
Builder. 

Go ahead and add the visual elements you need: the three labels and the 
segmented control. You’ll need to add a simulated tab bar to make sure 
everything will fit. Don’t worry about the Save button for now. 



In FugitiveDetailViewController.m (and .h) # add properties 
and initialization code. 

Now that all those interface elements exist, give them the back end in 
Xcode, but don’t worry about linking them just yet... 


you are here ► 
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exercise solution 



ExeRctSe 

SointloH 


Here are the additions to the view and 
the code to support them. 


o Open up FugitiveDetailViewController.xib in Interface Builder 


iPhone A FugitiveDct 


Segmented Conlrat - Yes. 


D B » ♦ ^ O 


Se 9 «nenlcd 

Styir Plain 


Tiic sclented tor\*tv"ol 
r\ccds {p be 6or\-fi3iA\rcd 
(i 七 says -f'i\rs*t/sctor\d 
by default). 



Mate ^ Mom^nlAry 
Twit j Default 




This is the label that 
will hold the ^aptuv-cd 
date 3 hd time, but 
its Cr^pty uhless the 
switch is "toggled -fco 
Yes. 



Fugitive Name 

Fu 9 >tivo 10 # 

Lorem ipsum dolor sil er elit 
lamet. consectetaur cillium 
adipisicing pecu, sed do 
eiusmod tempor incididunt ut 
labore et dolore magna 
aliqua. Ut enim ad minim 
veniam, quis rtoslrud 

ty: $1,000,000 
Captured/ fi No 


Segment Swncnt 0 • Y«» 

曹 itflr Y ㈣ 

Mnagc i*n«gc 

B<K*viof 0 Cnabkd ^ Select 

A — 


Conttvit Offset 


X 


AJignmefit [ ( 


0 


It) 



H 


Horlzonul 

n — 只 n 

Verticil 


m 


，二 Highl»glK#<1 
已 Selected 0 


View 



Ta FiM 


D {} O ■ 


LOO ' 


Capture Date & Time: 


\ Obiciu 






Label 


1 

2 


T«*t 


■ 


❺ 




this sclc^tioh 
"to the othev- 
K^l-r o-f "tKc doh*tvo|. 


Make suve w Sc^mcr>*t O - 
Ycs w is sclcd*tcd air>d bo*tV> 
sc^mcv>*U av*c enabled- Well 
r\tt& *tV>is m 3 


In FugitiveDetailViewController.m (and .h) # add properties 
and initialization code. 



UlSegmentedControl *capturedToggle 
UILabel *capturedDateLabel ; 


Add this ihsidc 
~ "the @ih-tc\r-Pa^c. 



hdd this with 

"the o-thev- & 
p\ropc<rtics. 


©property (nonatomic, retain) 
★capturedToggle; 

©property (nonatomic, retain) 
*capturedDateLabel; 


IBOutlet UlSegmentedControl 


IBOutlet UILabel 




FugitiveDetailViewController. h 
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- (void) viewWillAppear : (BOOL)animated { 


[super viewWillAppear:animated]; 


self.nameLabel.text = fugitive_.name; 

self.idLabel.text = [fugitive—.fugitivelD stringValue]; 
self.descriptionTextView.text = fugitive_.desc; 
self.bountyLabel.text = [fugitive—.bounty stringValue]; 

self.capturedDateLabel.text = [fugitive 一 . captdate description]; 

self.capturedToggle.selectedSegmentlndex = [fugitive_.captured 
boolValue] ? 0 : 1; 

} 


Cohvcirt the date 

"to 占 label -fov -the 

dcs^viptioh. 



Set "tiic bdsed 01^ v/hethev* "they 

ave tap-tuv-cd- 0 — /ES, / — ^ 0 - 


- (void)dealloc 

[fugitive release]; 

[nameLabel release]; 

[idLabel release]; 
tdescr.p^onTextV.ew^ release]; 
[bountyLabel— release]; 
[capturedToggle— release]; 
[capturedDateLabel_ release]; ] 

[super dealloc]; 






this! 

Finally, link the 
capturedToggle outlet 
for the segmented 
control to File’s Owner 
in Interface Builder. 


FugitiveDetailViewControllBr.m 
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test drive 




Tqst DriVQ 




Fugitives 


Henry Lewis 

17887 


Car theft and drug 
possession. 


Bounty: 22000 


Captured? 




Capture Date & Time: 



All tke view 
elements look gooct! 
Vow we just need 


to implement tkeir 
tekaviors*** 


th&re^ctre no o 

Dumb Questi9ns 


Why didn’t we use the switch instead of 
the segmented control? 

Because there's no Apple-sanctioned way 
to change the text of the switch. By default, the 
options are On and Off, which won’t work for us. 

Why didn’t we use a checkbox for the 
captured field? 


It turns out that the checkbox isn’t a standard 
control. It’s certainly surprising, since you see 
them so often in iOS apps. 

They can be done, however, by creating a custom 
button with three images (an empty box, a 
selected box, and a checked box), and switching 
between them. 
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Toggle Code Magnets 

Now that we have the controls laid out the way we want 
them, we need to actually give them some behavior. Use the 
magnets below to implement the method that will handle the 
segmented control switching. Then everything will be ready 
for linking to the segmented control in Interface Builder. 


-( 工 BAction) capturedToggleChanged : (id) sender 


if 


[NSDate 


self.capturedDateLabel.text = [fugitive_captdate 
description]; 

=[NSNumber numberWithBool:YES]; 


else 


=nil; 

fugitive •captured = [NSNumber numberWithBool : NO] 


self.capturedDateLabel.text 







self.capturedToggle.selectedSegmentIndex 
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toggle code magnets solution 




Toggle Code Magnets Solution 

Now that we have the controls laid out the way we want 
them, we need to actually give them some behavior. Use the 
magnets below to implement the method that will handle the 
segmented control switching. Then everything will be ready for 
linking to the segmented control in Interface Builder. 


一（工 BAction) capturedToggleChanged : (id) sender 




Oh 


OUh 


doir brol. 



This will ohly be called 
the value actually 

so the selected ihdex is 
how O, the -fuji-tivc v/Ss^-i 
^aptu\rcd piriov- -to -this c,a\l 


=[NSDate date ] 产 


TWis Will 3 ^ 

KSPatc sc*t bo 

灼七 date 


self.capturedDateLabel.text 
description]; 


[fugitive_captdate 


fugitive—.captured 


else 


ugitive 一 .captdate 



=[NSNumber numberWithBool:YES]; 

Cov-c Pa-ta st>v-cs boolean as 
KSNumkcvs, so 
ouv boolean VK/NO values 
=nil; *to u^d3*bc *bV>c ^ 5 * 


fugitive—.captured = [NSNumber numberWithBool:NO]; 

|-f -the -Punitive is〆 七 daftuved, dlcav- -the 
old taf*tu\rc da*tc i-P *tV>cv-c was one¬ 


self. capturedDateLabel.text 

This will \rctu\rh a text _ 

<rcp\rcsch-b-tioh o( ah /VSpa-tc. 







TllCSC v/crc 

c 火 tv* as … 


Tesr DriVq 


Add the code above to 

FugtiveDetailViewGontroller.m and don’t forget 
the corresponding declaration in the .h file: 

-( 工 BAction) capturedToggleChanged : 
(id) sender; 


Link the Value Changed event 
from the segmented control to the 
capturedToggleChanged and the 
captureDateLabel action to the empty 
Date & Time label in the Files’s Owner 
in Interface Builder. 
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migrating and optimizing with core data 



Tesr DriVq 


Now that all that work is done, you should have a 
functioning detail view. Give it a try... 



丁 looks 

yea 七 

d.oy\*tv-ol is sc*t I 

|^/o) jus 七 

i 七 should kc- I 


Caplyre Data & Hm*: 


Carrier V 


3:07 AM 


rUdiliV^Ai 


Ralph Gustav 

的 05 # 


Rrin iWogm mvc^linq nnp 


Bounty: 8&000 


|-f you 七 V>c 

sc^w'C^'tcd toy\*bv*ol) 
i\st da 七 c a”d few 
av-c Lllcd W 




OK, but if I come in and out of 
the app y ifs not restarting. Whafs the deal 
with that? I thought that only one app was 
running at a time... 


O 


That was true before iOS 4. 

Now developers can access multitasking behavior 
on iPhone. That means that apps don’t terminate 
when you leave them, or the phone rings, or you flip 
over to your iPod to change your music. So what 
does that mean for iBountyHunter? 
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saving with managed object context 

Your app has a lifecycle all its oww." 

The Core Data template we used tries to save our data when our application quits (look 
in applicationWillTerminate). The problem is, as of iOS 4, most iOS devices support 
multitasking and the application lifecycle has changed. 

Because of the constraints of mobile hardware, the applications aren’t running in a full 
multitasking model like you’d see on a desktop. Instead, applications have a very specific 
lifecycle they go through as iOS starts and stops them. 


、七 




application : didFinishLaunchingWithOptions 



applicationWillEnterForeground : 



^ 二 
0r 


l/Vhe” you\r app is visible ； you’ll 
active. This dah also 
happen i-P i\)c usev- Uhlodks the 
ahd youVc still 
TO\r example. 




applicationDidEnterBackground : 

J 


bade 


y° u,r 岬 pli 以 io» 


i5 Uc 







applicationDidBecomeActive 


v/our a?? 』 — a ^ d 

heve - 矿娜 y 七七’吒 

U| cvc^-b, y^cv-allY Ao\^ 
vernal a\>? 咖呼 . 


applicationWillResignActive : 
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Multitasking rules of engagement 

Apple provides excellent documentation in the iOS Application Programming guide detailing each 
state transition and the corresponding method calls and notifications you’ll receive. A couple points 
are critical, however: 



You have a limited time to handle moving to the background. 

You have approximately 5 seconds to return from applicationDidEnterBackground before 
iOS takes action and suspends or kills you. At a minimum, you should save any modified 
user data when moving into the background. You should also save application state 
information you might want to restore the application to where the user left it. They shouldn’t 
know that your application was terminated between when they left it and when it restarted. 



You can request more background time if you need it. 

There are limited things you can do in the background state, but if you need more time 
or want to maintain some network connectivity, for example, you can request it in your 
applicationDidEnterBackground: method. 




Once you enter the background state, you wont be told if youre killed. 

Once you enter the background state, iOS will try to keep you in memory in the suspended 
state. However, applications are terminated based on resource availability, so if you can reduce 
memory usage, your app may run longer. Your app will not receive any further notifications 
before it’s killed off, which is why it’s so important to persist everything you need to start up 
again later as soon as you get backgrounded. 

If the device doesn’t support multitasking, your app will be terminated. 

If the device your app is running on doesn’t support multitasking (iPhone 3G, for example) 
or you have opted out of multitasking support, your application is simply terminated 
when the user leaves it. This is similar to the pre-iOS 4 behavior and you will receive an 
applicationWillTerminate : call before you’re shut down. 


%|harpen your pencil 


Add the save code to the right place to handle multitasking. 


Copy [self save Context] from applicationWillTerminate in iBountyHunterAppDelegate.m. 

The apf*to 七 evmma 七 e 

•i 七 ’s "to 

mu Itiiaskm^ suffovt- — ^ 

Paste [self saveGontext] in applicationDidEnterBackground in iBountyHunterAppDelegate.m. 
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always be saving 


|Jharpen your pencil 

Solution 


Relocate the save code to the right place to handle multitasking. 



The Managed Object Context saves new or changed items 

We’ve used the managed object context to load our Fugitives, but it is also responsible for coordinating 
saving your data. Remember how NSManagedObject can keep track of changes to entities? The 
Managed Object Context can take advantage of this information to tell if you if there are any 
changes in the objects it’s managing. Similarly, if you create a new instance of an N SManagedObj ect, 
you need to tell it which Managed Object Context it belongs to and that Managed Object Context 
knows it has new entities to keep track of. The Gore Data template takes advantage of this during 
application exit to see if the Managed Object Context has any new or changed data. If it does, the 
application simply asks the context to save them. 


TW«s template toAtJyo^ 

汜⑽切 w ， s 本 

as 70U 

七 a 代 . 
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You said if I create new instances 
of NSManagedObjects, I need to tell them 
which Managed Object Context they 
belong to. How do I do that? 

It's part of the EntityDescription we 
mentioned earlier. If you want to create a 
new instance of an NSManagedObject, you 
just do this: [NSEntityDescription insertNew 
ObjectForEntityForName:@”Fugitive” inMan 
agedObjectContext:managedObjectContext]; 
The Managed Object Context is provided 
right from the start. 

What’s the “&error” that’s being 
passed to the save call? 

Most Core Data load/save operations 
point to an NSError in case something goes 
wrong. The in Objective-C behaves 
just like it does in C or C++ and returns the 
“address of the item. We declare a pointer 
to an NSError, then pass the address of 
that pointer into the save method in case 
something happens. If the save call fails, 
Core Data will populate that error argument 
with more detailed information. Keep in mind 
that just checking for an NSError does not 
work for determining if a method succeeded. 
For that, you should check the BOOL return 
value, since the error is only tracking if 
success was NO. 



Speaking of errors, what should I 
do if this comes back with an error? 

That’s really application-specific. 
Depending on when you detect the problem, 
you can warn the user and try to recover; 
other times, there’s not too much you can 
do. For example, if the error happens during 
the applicationWillTerminate method, there’s 
not much you can do other than tell the user 
the save failed and possibly stash the data 
somewhere else. 

Should I only ever call save in 
applicationWillTerminate? 

No, not at all. The Core Data template 
set it up this way for convenience, but you 
should save whenever it’s appropriate in 
your application. In fact, if you’re using a 
SQLite database backend for your data, 
saves are significantly faster than when we 
were working with plists in DrinkMixer. You 
should consider saving additions or changes 
to the data as soon as possible after they 
are made to try to avoid any kind of data 
loss. 

You said Core Data could do data 
validation; where does that fit into all of 
this? 


At a minimum, Core Data will 
validate objects before they’re stored in the 
Persistent Store. So, it’s possible that you 
could get a validation error when you try to 
save your changes if you have invalid data 
in one of your managed objects. To avoid 
such late notice, you should validate your 
NSManagedObjects as close to the time 
of change as possible. You can explicitly 
validate a new NSManagedObject like this: 
[fugitive validateForlnsert:&error]. Similarly, 
there are methods for validating updates and 
deletes. You can call these methods at any 
time to verify that the NSManagedObject is 
valid against constraints you put in the data 
model. If it's not, you can notify the user and 
ask them to correct the problem. 

Q/ What if I don’t want to save the 
changes in the Managed Object Context? 
Can I reset it? 

It’s easier than that—just send it the 
rollback: message. When a Managed Object 
Context is told to roll back, it will discard 
any newly inserted objects, deletions, and 
unsaved changes to existing objects. You 
can think of the Managed Object Context 
as managing transactions—changes to 
entities, including insertion and deletions, 
are either committed with a save: message 
or abandoned with a rollback: message. 
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bob's demo 


A quick demo with fob 

After seeing the detailed view and all the captured stuff, 
Bob’s thrilled, but has one quick comment: 



After all that, we 
forgot to populate the 
Captured list! 
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migrating and optimizing with core data 


OK, I know how to populate the table cells and 
stuff—but how can I only pick captured guys? 



We can use Core Data to 
filter our results. 

We already have capture information in 
our Fugitive data; we just need to use it 
to get the Captured list. We need a way 
to tell Gore Data we only want Fugitives 
where the captured flag is true. 





Where is a natural place to put 
this kind of filtering? 
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predicates in Xcode 


Use predicates for filtering data 


In database languages all over the world, predicates are 
used to scope (or limit) a search to only find data that match 
certain criteria. Remember the NSFetchRequest we talked 
about in Chapter 8? For that we used the Entity Information 
and Sort Descriptor, but we haven’t needed the predicate 
support...until now. 


NSFetchRequest 



E 灼 七》切 |r\-fo\rw>a*tior\ *tclU CoV"C , 

Pa*ta type o-P data wc 

-fov- (and ba 乙 k). 

f*OV" \AS, *tWis IS d Fugitive 


、 ， 

Wtrts -bKc ^\tCt v/c hW 七 used 

bcW. TVic ^cd'idatc ㈣ Wes 

do^ditio^s i\\t data must maUVv l*f 

*,-t doesn't it dotsr!i 

V"C*tuv*ir\cdi *tV^c v*csul*ts- 


NSFctchRcqucst concepts arc nearly 
identical to SQL 



S 夕 L is a la 呼 ay 
used -fov 
di3"t3 ^^ scs， 


Wt used Sort 
Pcstv-*i\>*tov- *to ovdev- *tV^c 

data al^abct^allY m i\\t 

\rcsul*b. 


The three major concepts in an NSFetchRequest are 
nearly identical to the expressions in standard SQL. 
Here’s what that would look like: 


SELECT * FROM tuGIT^^S WHERE {captured 





ou\r 


This is s“ ^ _ / 

ih4.. Hoi exactly 
the sar^c, but dlosc. 


fWs ihc S 夕 L 



All we need to do is provide the predicate information 
to our NSFetchRequest and Gore Data handles the 
rest. We can use an NSPredicate for that... 
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Wc need to set a predicate ow our NSFctchRcqucst 

NSPredicate is a deceptively simple class that lets us express logical constraints on our 
NSFetchRequest. You use entity and attribute names along with comparison operators to 
express your constraint information. You can create a basic NSPredicate with a string format 
syntax similar to NS String, like this: 


NSPredicate ^predicate = [NSPredicate 
predicateWithFormat : @^captured == YES〃]; 

[request setPredicate:predicate]; 

But NSPredicates don’t stop with simple attribute comparisons. Apple provides several 
subclasses like NSGomparisonPredicate, NSCompoundPredicate, and NSExpression, as 
well as a complex grammar for wildcard matching, object graph traversal, and more. You 
can even build complex fetch requests graphically in Xcode. For iBountyHunter, a simple 
attribute condition is all we need to get Bob’s view working, so we’ll create the predicate 
programmatically. 



Time to populate the Captured view! There’s some work 
to get the Captured view updated to where the fugitive 
view is, and then a tweak to display what we need. 



Set some captured fugitives. 

Build and run the old version of the app and toggle a handful of the 
fugitives to “captured” before making any changes. You’ll need that for 
testing. 



Update the Captured view to match the Fugitive view. 

When we left off in Chapter 8, we hadn’t yet done the work to populate 
the Captured list. Since we’re just going to be filtering the data that’s in the 
Fugitive list, the easiest way is to start with the entire list and then add the 
filtering code. Don’t forget the tableview datasource and delegate methods. 



Add the predicate code. 

Update your NSFetchRequest to use an NSPredicate so it only finds 
captured fugitives. This needs to go into the viewWillAppear method in 
the GapturedViewGontroller.m. 
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updating the captured view 


mm, 

ExeRciSe 
SoLutiOH 


You should recognize the code from Chapter 8 to get the captured 
view working, and then add the predicate code to get the filtered data. 


o 

❺ 


产丄 丄 」 • 丄 . y 一 vius 七 do 七 his -through ihc 

Set some captured fugitives. ^ a PP -a,y ^ -bhat you ^ 
Update the Captured view to match the Fugitive view. 


Qinterface CapturedListViewController : UITableViewController { 

©private 

NSMutableArray *iterns—; Create av-v-ay "to s*tov-c 



©property (nonatomic, retain) NSMutablearray *iterns; 


CapturedListViewController.h 


^import ''CapturedListViewController. h" 

#import ''Fugitive .h 〃 

#import ''iBountyHunterAppDelegate. h 〃 

#import ''FugitiveDetailViewController. h 〃 
@synthesize iterns=items_; 


Make suv-c *bV^c 
viev/ is all 七 & 

delegates ay\d da*ta 七 ha 七 
y/c y\ccd- 



/W 七 ho\rs’ Step Z toAt do^tmucs oy\ pa^cs 午 02 •—午 03. 


CapturedListViewController.m 
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- (void)viewWi11Appear : (BOOL)animated 


[super viewWi11Appear : animated]; 


Tliis todt is exactly 
same todt that 
we used foY the 

Fu0i"tiv/cL-is't\/icy/Coh'tirollcv". 


iBountyHunterAppDelegate *appDelegate = (iBountyHunterAppDelegate*) 

[[UIApplication sharedApplication] delegate]; 

NSManagedObj ectContext *managedObjectContext = appDelegate. 
managedObjectContext; 

NSFetchRequest *request = [[NSFetchRequest alloc] init]; 
NSEntityDescription *entity = [NSEntityDescription 
entityForName : @"Fugitive" inManagedObjectContext : managedObjectContext]; 
[request setEntity:entity]; 

NSSortDescriptor *sortDescriptor = [NSSortDescriptor 
sortDescriptorWithKey : @"name" ascending:YES]; 

[request setSortDescriptors : [NSArray arrayWithObject:sortDescriptor]] 




NSPredicate *predicate = 

YES"]; 

[request setPredicate:predicate]; 


[NSPredicate predicateWithFormat : @’’captured 

o Add the predicate code. 


NSError *error; 

NSMutableArray *mutableFetchResults = [[managedObjectContext 
executeFetchRequest : request error : &error] mutableCopy]; 
if (mutableFetchResults == nil) { 

// Handle the error; 


self.items = mutableFetchResults; 

[mutableFetchResults release]; 

[request release]; 

// Since the user could have changed how many fugitives are captured, 
we need to reload our table view 
[self.tableView reloadData]; 


CapturedListView 


3 

stViewControll 


er.m 
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exercise solution 


E%eRc\Se 

SotutlOH 


You should recognize the code from Chapter 8 to get the captured 
view working, and then the predicate code to get the filtered data. 


Get the Captured view to match the Fugitive view (continued). 



^pragma mark Table data source 

- (NSInteger)numberOfSectionsInTableView:(UITableView ^)tableView 

{ 

// Return the number of sections. 
return 1; 

} 

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NS 
Integer)section 

{ 

// Return the number of rows in the section. 
return [items 一 count] ; 

: (u _ 

Path : (NSIndexPath ^)indexPath 

static NSString ^CellIdentifier = @ 〃 Cell 〃； 

UITableViewCell *cell = [tableView dequeueReusableCellWithldentifier 
: Cellldentifier]; 

if (cell == nil) { 

cell = [[[UITableViewCell alloc] initWithStyle:UITableViewCellSt 
yleDefault reuseIdentifier : Cellldentifier] autorelease]; 

} 

// Configure the cell... 

Fugitive *fugitive = [items 一 objectAtlndex : indexPath.row]; 
cell.textLabel.text = fugitive.name; 

cell.accessoryType = UITableViewCellAccessoryDisclosurelndicator; 

return cell; 


CapturedListViewController.m 
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#pragma mark - Table view delegate 

- (void)tableView:(UITableView*)tableView didSelectRowAtlndexPath:(NSIndexPa 
th *)indexPath { 

FugitiveDetailViewController *detailViewController = 

[[FugitiveDetailViewController alloc] initWithNibName:@〃FugitiveDetail 
ViewController 〃 bundle:nil]; 

detailViewController.fugitive = [self.resultsController 
objectAtlndexPath:indexPath]; 

[self.navigationController pushViewController : fugitiveDetailVie 
wController animated:YES]; 

[detailViewController release]; 


- (void)dealloc { 

[items 一 release]; 

[super dealloc] 


CapturedListViewController.m 





Tesr DriVq 


Go ahead and fire it up—the captured 
view should be ready to go! 
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test drive 




TesT DriVq 



Captured 


Fiona Westin 
I. Stol eit 
John Irahia 
Nick Forsee 
Vincent Grey 


Fugitives Captured 




Fiona Westin 


35805 


Assault, and theft of a pet 
dog. 


Bounty: 67000 


Captured? 



No 


Capture Date & Time: 2011-03-2717:30:42 +0000 



Fugitives 


Captured 



It works! Tkese are tke live 
fugitives we markect as captured. 
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Hang on—you said we should be careful with 
memory and performance and blah blah...Now we 
have two arrays of fugitives and we reload them 
every time the view appears. It seems pretty 
dumb. What if we moved this code to viewDidLoad 
so \ fs only done once per view? 


True, we can make this a lot more 
efficient. 

But not by moving it to viewDidLoad. If we move the 
code there, we’re going to end up with two new problems. 
We need another solution... 


What problems would we introduce if we moved 
the fetching code to viewDidLoad? What else 
could we do to improve performance? 
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results handling 


Core Pata controller classes provide efficient 
results handling 

The code for both the FugitiveListViewGontroller and the GapturedListViewGontroller is 
in viewWillAppear. The problem is that viewWillAppear gets called every time the view is 
shown, which means we’re reloading all the fugitives and all the captured fugitives every 
time, regardless of whether anything’s changed. 


We could move the code to viewDidLoad, but that only gets called when the views are 
loaded from their nibs. That causes two problems. First, if we mark a fugitive as captured, 
the Captured List won’t reflect that since it only loads its data once. The second problem 
is that viewDidLoad gets called before our applicationDidFinishLaunching, which means 
the views will try to get their data before the app delegate gets a chance to copy the master 
database in place. What we need is a better way to manage our fetched data. 


Table views and 

NSFetchedResultsControllers are made 
for each other 



Fiona Westin > 

I. Stol eit > 

John Irahia > 

Nick Forsee > 

Vincent Grey > 







Since UITableViews are such a common component 
and frequently deal with large amounts of data, there’s 
a special Gore Data class designed to support them. The 
NSFetchedResultsGontroller works together with the 
Managed Object Context and your NSFetchRequest to give 
you some pretty impressive abilities: 

Very efficient memory usage 

The NSFetchedResultsGontroller works with the NSFetchRequest and 
the ManagedObjectModel to minimize how much data is actually in 
memory. For example, even if we have 10,000 fugitives to deal with, 
the NSFetchedResultsGontroller will try to keep only the ones the 
UITable View needs to display in memory, probably closer to 10 or 15. 

High performance UITableView support 

UITable View needs to know how many sections there are, how many rows 
there are in each section, etc. N SFetchedResultsG ontroller has built-in 
support for figuring that information out quickly, without needing to load 
all the data. 




Built-in monitoring for data changes 

We’ve already talked about how the Managed Object Context knows 
when data is modified. NSFetchedResultsGontroller can take advantage of 
that to let you (well, its delegate) know when data that matches your fetch 
results is modified. 
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Time for some high-efficiewcy streamlining 

We need to do a little refactoring to get NSFetchedResultsGontroller 
in there, but when it’s done, Bob could give us a database of 100,000 
fugitives and iBountyHunter wouldn’t blink. We’re going to do this for the 
GapturedListViewGontroller, but the same refactoring can be applied to the 
FugitiveListViewGontroller, too. 

First, we need to replace our items array with an instance of an 
NSFetchedResultsGontroller, like this: 


do^tv-ollcv- *to tell US 
诎⑼ data 
Y^ttd -to 

delete 


Qinterface CapturedListViewController : UITableViewController 

<NSFetchedResultsControllerDelegate> { 

Qprivate 

NSFetchedResultsController *resultsController 


©property (nonatomic, readonly) NSFetchedResultsController 
*resultsController 

WlcVc dv-catmg a v-cad-o^ly pv-ofev-ty 

s\Y\tt v/c do 灼’七 v/3^*t a^yo^c '*t- 



@end 



CapturedListViewController.h 


@implementation CapturedListViewController Remove its 

_ py-oPCV"*tv- Wc >woy>’ 七 七 hose BrN 

Sgyrv^hesizQ itemc—itcmg- ; ^ 1 x 1 


oir^ev*. 


- - 


- (void)dealloc { 

[resultsController 

[super dealloc]; 

} 

@end 




release] 


Delete the \rc-fc\rchdc "to the 

iterws a\r\ray hc\rc av\d release 
the hew dohilrollcV". 



CapturedListViewController.m 


Next we neect to ckange tke 
searck to use tke controller... 
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use the controller 


Create the m\N FetchedRcsultsCowtroller getter method 


- (NSFetchedResultsController *)resultsController { 

// If we A ve already initialized our results controller, just return it 

if (resultsController != nil) { NSFe^eaResultsCo^olle, tell 

US dald y/c only need -to actually 


return resultsController 


oy\U> l*f wc ; vc already deme (如 view 
"is shoym wc jus*t bail- 


// This must be the request for our results controller. We don't have one 
// yet so we need to build it up. 

iBountyHunterAppDelegate *appDelegate = (iBountyHunterAppDelegate*)[[UIApplication 
sharedApplication] delegate]; 

NSManagedObj ectContext *managedObjectContext = appDelegate. 
managedObjectContext; 

NSFetchRequest ^request = [[NSFetchRequest alloc] init]; 

NSEntityDescription ^entity = [NSEntityDescription entityForName:@"Fugitive" 
inManagedObjectContext : managedObjectContext]; 

[request setEntity:entity]; 

NSSortDescriptor *sortDescriptor = [NSSortDescriptor 
sortDescriptorWithKey:@ 〃 name" ascending:YES]; 

[request setSortDescriptors : [NSArray arrayWithObj ect : sortDescriptor]]; 

NSPredicate ^predicate = [NSPredicate predicateWithFormat:@〃captured == YES’’]; 
[request setPredicate:predicate] ; ^ m ^ ia | l2jC N£Fc*U^caRcsul*bCo^vollcv 如妞 

ouv- v-c^ucst a^a 

resultsController— = [[NSFetchedResultsController alloc ]< ’ 
initWithFetchRequest : request 

managedObjectContext : managedObjectContext 

sectionNameKeyPath : nil cacheName : @"captured 一 list•cache"]; 
resultsController .delegate = self; 


NSError *error; 

BOOL success = [resultsController 一 performFetch:&error] 

if (! success) { Uo, mstead asM 

// Handle the error; Object Model *to 
} y/e ask doy\*tv-ollcv-. 

[request release]; 
return resultsController ; 


CapturedListViewController.m 
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Hmm, so if we get rid of the array 
of Fugitives, then were going to have to 
re-implement the datasource and delegate 
methods too, right? My guess is were going 
to use the NSFetchedResultsController 
there as well? 


Yes- 

The NSFetchedResultsController gives us everything we 
need to access the fetched data. In fact, it can do it a lot 
more efficiently. 


^j^rpen your pencil 


We’ve given you the code to set up the 
NSFetchedResultsController. Now you need to 
update the tableview delegate and datasource 
methods to use the controller instead of the view. 



Refactor numberOf SectionsInT able View and 
numberOfRowsInSection to use the controller. 

NSFetchedResultsController has a sections property that is an 
array of NSFetchedResultsSectionlnfo objects. Use those to 
figure out how many sections there are and how many rows in 
each section. 



Refactor ce 11 For Ro w A tlndexPat h and 
didSelectRowAtlndexPath to use the controller. 

NSFetchedResultsController makes it easy to implement these 
methods using its obj ectAtlndexPath method. 


you are here ► 


489 






sharpen solution 

%|harpen your pencil 

Solution 


Here is the final code for CapturedListViewController.m 
table methods. 


#pragma mark Table data source 


- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView { 

return [ [self.resultsController sections] count] ~x 
. pov number settlors, wc 

// Customize the number of rows in the table view. ^ 4-^C C.on'tv'ollcv 

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger) 
section { 

return [[ [self.resultsController sections] objectAtlndex : section] 
numberOfObjects]; 

} 

// Customize the appearance of table view cells. 

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtlndexPath:(NS 
工 ndexPath *) indexPath { 

static NSString *CellIdentifier = @ 〃 Cell 〃； 

UITableViewCell *cell = [tableView dequeueReusableCellWithldentifier:Celll 
dentifier]; 


if (cell 


nil) 


cell = [[[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault 
reuseldentifier:Cellldentifier] autorelease]; 

} 

// Set up the cell... 

Fugitive ^fugitive = [self.resultsController 
ob jectAtlndexPath : indexPath] ； (sfotWi% -Panty kve — jus 七 yt 

cell.textLabel.text = fugitive.name; pujitwc a*t 3 »心 mde’Pa 七 Vv 

cell.accessoryType = UITableViewCellAccessoryDisclosurelndicator; 
return cell; 


CapturedListViewController.m 
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#pragma mark - Table view delegate 

- (void)tableView:(UITableView*)tableView didSelectRowAtlndexPath:(NSIndexPa 
th *)indexPath { 

FugitiveDetailViewController ^detailViewController = 

[[FugitiveDetailViewController alloc] initWithNibName : @^FugitiveDetail 
ViewController^ bundle : nil]; 

detailViewController.fugitive = [self.resultsController 
objectAtlndexPath:indexPath]; 

[self.navigationController pushViewController : fugitiveDetailVie 
wController animated:YES]; 

[detailViewController release] ; Ov\t mov-c lookup *fov- 仏 e *to_ 


yt Furtive, y/cVc all set 


- (void)dealloc { 

[resultsController 

[super dealloc]; 


release] 



CapturedListViewController.m 




Tesr DriVq 


Go ahead and run iBountyHunter to make sure the changes didn’t break 
anything. The views should be loading just like they were...sort of. Do some 
quick testing—if you mark a fugitive as captured, does he switch lists? What if 
you exit and come back into the app using the Home key? 
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test drive 




Tesr DriVq 


Now that you’re using the controller instead of just a predicate, the 
behavior of the app should be the same. But people are showing up 
in the Captured list even when they’re not marked as captured! 






Why aren’t fugitives properly changing lists 
when you change their captured status? 
Hint: think back to the “Five-Minute Mystery’ 
from Chapter 6 … 
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migrating and optimizing with core data 


Wc need to refresh the data 


The fugitives aren’t properly changing lists when you change 
their status because we’re not refreshing the data every time 
the Captured list view is displayed. We need to set up the 
NSFetchedResultsGontroller to let us know when things have 
changed so we can update the table. 






- (void)controllerDidChangeContent : (NSFetchedResultsController *)controller 


[self.tableView reloadData] 




V® u add this ih the 

Cap"tu\rcdLis't\/icy/Coh't\rollc\r.r^ -pile ， 


Wic 3sk y/iiolc 't^blcviCNw *to vclo^d i*bs 乙七 

a TKcvc art mov-c ⑶七 mcay>s jus 七 vcloadi^ 

modified v-oy/s you have \aryy iablcviows. 

NSFetchedResultsController caw check for changes 


Now that we’ve set up the app to work with the NSFetchedResultsController 
instead of just an array, we can leverage the methods embedded with the 
controller to help us. The view controller has built-in support for monitoring 
the data for changes through a delegate. We had set ourselves up as that 
delegate but never implemented the code to handle data changing. 


Having the view completely reload when it detects a change can become 
cumbersome if you are dealing with a large amount of data; however, the 
FetchedResultsG ontroller delegate also has support built-in for notifying 
you of the specific cell that is changed, and you can modify just that. Check 
Apple’s documentation for more details. 




Tesr DriVq 


Implement the controllerDidChangeContent 
method from above, and make sure 
everything’s working. 



CapturedListViewController.m 
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test drive 




TesT DriVq 


Do the same thing you did last time, build and run, and 
then change the status of one of the fugitives to pull 
him dynamically out of the captured list. 







PM 


Carrier 


Captured 


Emmanuel Uttenburg 
Fiona WestiiV — 

G&orge Tallin 


Hunter Sweeney 
1. Stol dt 


Captured 




3:00 


PM 


earner 


-iona Wcsun 


Nick Forsee 


Vincent Grey 


36 BD 6 


Assauli, firni meft of .1 pot 

dog. 


Bounty: 67000 
CaptuTed? 


Emmanuel Uttenburg 
George P&Wn 
Hunter Sweeney 
I. Stol eit 


Nick For see 
Vincent Grey 


y/ith 7 dap-tu\rcd 

-Pugi-tivcs... 


..V-CmoVC OY\t -fvom *tV>C llS 七 … 


•a 灼 d she’s immcdia'tcly 301 ^! 
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migrating and optimizing with core data 


This is awesome! The advantage I*m going 
to have over the competition is great, 
and having all that information with me means 
that ril be making way fewer trips back to 
the police station. Thanks! 


There’s nothing like a 
satisfied customer! 


you are here ► 
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no dumb questions 


Where can I find the full syntax for 
NSPredicate? 

NSPredicate has a pretty complex 
syntax available for expressing constraints 
on your data. There’s a simple summary 
available in the NSPredicate class 
documentation, but Apple has an entire 
document available to help you write 
advanced predicates. 

It seems like it would be pretty 
easy to make a mistake typing predicate 
syntax into code like that. Isn’t that sort 
of like embedding SQL? 

Yes, and Xcode can offer a lot of help 
here. Instead of embedding your predicates 
in code, you can build them graphically 
using Xcode’s data modeler, just like we did 
with the Managed Object Model. To build 
a predicate graphically, select an entity in 
Xcode, then click on the plus as though you 
were adding an attribute. Select “Add Fetch 
Request” to create a new fetch request and 
click Edit Predicate to bring up the graphical 
editor. You can name your fetch requests 
whatever you like. You’ll need to retrieve 
them in code like this: 


thereiare no ^ 

Dumb Questi9ns 

NSFetchRequest *fetchRequest 
=[managedObjectModel 
fetchRequestFromTemplateWithName: 
@”capturedFugitives” substitutionVariables:[ 
NSDictionary dictionaryWithObject:capturedF 
lag forKey:@’’captured’’]]; 

Then just use that fetch request instead 
of one created in code. You can also use 
Xcode’s builder to assemble a predicate, 
then just cut and paste that into your code if 
you’d prefer to keep them there. 

Reloading the whole table when 
data changes seems pretty inefficient. 
Aren’t we trying to optimize things? 

Yes it is, and yes, we are. There are 
a number of delegate methods you can 
implement to get finer-grained information 
about what’s happening with the Managed 
Object Context. With that information, you 
can find out if you just need to update a 
specific table view cell, insert a cell, or 
remove a cell. We took the easier route 
and just asked the table view to reload 
completely. 

Q/ What’s with that cache value we 
gave to the results controller? 


The results controller will use that file 
name to cache information like the number 
of items, number of sections, etc. It will keep 
an eye on the data store and regenerate 
the cache if something changes. You can 
also forcibly ask it to remove a cache, but in 
general, you shouldn’t need to. 

Our results controller only has one 
section. How do I get it to split things into 
multiple sections? 

Just provide an attribute name 
for the sectionNameKeyPath. The 
NSFetchedResultsController will group your 
results using that attribute and return each 
grouping as a section. You can get really 
sophisticated and create a transient property 
if you want to group them by something 
you’re not actually storing in the database 
and calculate the value using a custom 
getter added to your object model. 


(^^BUUET POINTS —— 

■ NSFetchRequest can take an 
NSPredicate to filter data based on 
logical conditions. 

■ You can express NSPredicate 
conditions in code or using Xcode’s 
predicate builder. 


■ NSFetchedResultsController 
provides highly efficient memory 
management and change 
monitoring for UlTableViews 

■ Be careful about what you put in 
viewWillAppear, as it will be called 
every time your view is shown. 
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migrating and optimizing with core data 



DataMi^ration cross 

We have some new data lingo to try out, so flex those 
verbal skills... 



Across 

2. viewDidLoad and view_both load views, 

but with different frequency. 

5. The_is responsible for reading and writing data. 

7. Automatic migration is called_data 

migration. 

8. To update the data, we need to_it. 

9. The FetchedResultsController is good at_ 

management. 

10. NSFetchResultsController can_for changes. 


Down 

1._concepts are similar to NSFetchResults 

concepts. 

3. _are used for filtering data. 

4. The new model is the current_. 

6. The Managed Object Context saves new or_ 

items. 


you are here ► 


497 
























































datamigration cross solution 



DataMi^ration cross Solution 

We have some new data lingo to try out, so flex those verbal 
skills... 



Across 

2. viewDidLoad and view_both load views, 

but with different frequency. [WILLAPPEAR] 

5. The_is responsible for reading and writing data. 

[STORE] 

7. Automatic migration is called_data 

migration. [LIGHTWEIGHT] 

8. To update the data, we need to_it. 

[MIGRATE] 

9. The FetchedResultsController is good at_ 

management. [MEMORY] 

10. NSFetchResultsController can_for changes. 

[CHECK] 


Down 

1._concepts are similar to NSFetchResults 

concepts. [SQL] 

3. _are used for filtering data. [PREDICATES] 

4. The new model is the current_. [VERSION] 

6. The Managed Object Context saves new or_ 

items. [CHANGED] 
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migrating and optimizing with core data 




Your Pata Toolbox 

You’ve got Chapter 9 under 
your belt and now you’ve added 
migrating and optimizing data to 
your toolbox. 


Pcirsis-tcht 0\)\ 

^toire 

Actually ^ads ahd whites ih 

Poes daia migira-tioh, sometimes 
如七 hou 七此 tidily heedihg io load 

the daia. 

Wscs ma PP ih 3 wclels 4‘ 

扣 e too mudh ^ li 9 hWi 9 ht 


daia. 


Pa-ta Miyatuw 

Core Pata use 
database Aa 呼 s. 

Vcrsio^m^ IS used *to kcc\> 

七 he data miyatio 

6a^ be used 

•to add aU^butes ov Aa — 吒 
o^*t»oir\al s*ba*bus. 


3 CS 


、吐 〜心 ui Ulc]/i 


Saving 

The Ma^a^cd Obje^i Coh-tc^i 
handles savm^ irvev/ or dli^^cd 
i*tcrwS. 


cw 


Fi|-tc\rihJ Data 

Pv"cdid3*tcs 3v*c used *fo\r -Pil*tcHhj 

代 sulis da*ta. 


The pvedidate heeds -to be sci 

七 he hf£FeUhRc<\ucst 




ON 自 HJ@ 
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bob J s not done yet... 



It’s a good tltingf tke 
iPkone comes witk a 
camera •“ 
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10 camera, map k!t and core 

Tv- 

Proof in the real world 





iOS devices know where they are and what they see. 

As any iPhone, iPod Touch, or iPad user knows, these devices go way beyond just 
managing data: they can also take pictures, figure out your location, and put that 
information together for use in your app. The beauty of incorporating these features is 
that just by tapping into the tools that iOS gives you, suddenly you can import pictures, 
locations, and maps without much coding at all. 


this is a new chapter 





bob needs a picture 


For fob, payment requires proof 

Bob is working hard on getting as many fugitives off the 
street as he can, but to get paid he has to document his 
captures. 


I need a picture of the arrest when it happens, 
and since my phone has a camera, I was thinkinc 
you might be able to help out. This is more 
important than the iPad app y that can wait... 




That should be easy enough. 

Bob wants a picture of his catch and he’s 
going to need it to be pretty big — so let’s 
go ahead and put it on its own view. 

Those pictures will be great for 
advertising too, not to mention that it 
will speed up payment! 
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camera, map kit, and core location 


t^harpen your pencil 


Here’s what the app looks like so far. Where 
and how should we add photos? 



Am cilia Bones 
□avid Adams 
Emmanue( Uttenburg 
Fiona Westin 
George Pal in 
Henry Lewis 
Hunter Sweeney 
l Stol eit 





Captured 


Emmanuel Uttenburg 
George Palin 
Hunter Sweeney 
I. Stol eit 
Nick Forsee 
Vincent Grey 



Youv ideds hc\rc- 


Fiona Wesli n 

測 & 

and Iheli of a pet 

dog. 


Bounty: 67000 
Capturod? No 


C^pltiire A Timn EDnmo-jff miws; 
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a detail view worth flipping over 

<^ja 「 p6n your pencil 


^ Solution 


Spa 匕 e is jctimg 
3 bi-t "tight dovm 
hcv-c- I-P v/c shv-*mk 
up 七 he spade -Pov- 
七 he dcsdiripiio^ 
v/C ddrt rwovc the 

dap-tuve m-Po up 

3 灼 d Ic3vc Voorw 

"the i^cw burtfeon. 


Here’s what we came up with for the photo view. It 
could use some design love, but it’s functional. 



Fiona Westin 


Assault, and theft of a pet 



Bounty: 67000 
Captured? 


Flip ovc\r. 



Youll y^ttd -to 

sWmk tw»s ^ 

a 七 . 


Caught pho-fco. 



Tills IS {\\t 

bo*bto 州 of 

pov^c bu-tw *to 
*b^c 06*buvc 
bd£>k ovcv- 


Flip over for the detail view 

We can use a built-in animation for some nice usability with 
a little flair here. Since Bob will only want the photo after 
drilling down through to the detail view (what he’ll use to 
find his fugitive), it makes sense to stick it on the back of the 
detail view. 


This is a really common interface for the utility apps on the 
iPhone. Typically, there will be two views, one with an info 
button on it, and another that is revealed by flipping over 
when the info button is clicked. The flipping is just another 
transition that comes with UIKit. We can steal the idea to 
give a nice baseball-card look to our fugitive detail view. 

What kind of view will you need to implement 
for this? Hint: You used it for DrinkMixer... 
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camera, map kit, and core location 



ExegciSe 


o 


Enough planning and hints. Build the view 
and get it implemented! 


Build the new CapturedPhotoViewController. 

That’s going to mean a view with a UllmageView and a Done button. 
Don’t forget the action to tie in with the button and dismiss the view. 


y/o^Y about ^ \dOMti 
UllmajcV'iow yc*t ； well *to ^ a sedemd. 



Start with the FugitiveDetailViewController updates. 

The detail view needs a new info button, and an action to trigger the 
new flip view. The info button is just a regular button with the Info Dark 


type. 



P ‘ 七 -forjet bo Wttrn 

artd dMcrl 



Use a custom animation to show the new view when the 
info button is pressed. 

You already know how to present a modal view, but this time we 
want to do it with a custom animation. The animation you want to 
use is the UIModalTransitionStyleFlipHorizontal. Take a look at the 
UIViewGontroller documentation if you’re stuck on how to use it. 
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long exercise solution 



ExefictSe 
SoLytioM 


o 


This one is a whole bunch of functionality that you added 
without much help! Here’s what we came up with: 

Build the new CapturedPhotoViewController. 

Start by creating a new UIViewGontroller subclass, with a .xib file to 
use for our image. Make sure they’re under the / iPhone folder. 



@interface CapturedPhotoViewController : UlViewController { 


(IBAction) doneButtonP 


j 


Dcdlavc "the dd'bioir) -Pov- the button. 



@end 


CapturedPhotoViewContro 


7 




ler.h 




"the dohC bu"t"{joh is 
pv-csscd, wc waht the view 
"to go away. 

[self dismissModalViewControllerAnimated: YES]; 




(IBAction) doneButtonPressed { 




❺ Start with the FugitiveDetailViewController updates. 


CapturedPhotoViewController.m 


^ dd ^ 础 0h 铋 

P :r d “ ^ 



- (IBAction) showlnfoButtonPressed; 



FugitiveDetailViewController.h 



FugitiveDetailViewController.m 
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camera, map kit, and core location 


O Button 

Touch Down Repeat \ 

Touch Drag Enter m 

Touch Drag Exit 
Touch Drag Inside 
Touch Drag Outside 

Touch Up Inside » file's Owner 

showInfoButto 

Touch Up Outside 
Value Changed 
▼ Referencing Outlets 

KJoiti Doforor>/-i«n 史 


o 


Use a custom animation to show the new view 
when the info button is pressed. 


Ihs-tahtiatc the view dohtv-ollcv- 
opc^ up the -flip view h ib. 


- (IBAction) showInfoButtonPressed { 

CapturedPhotoViewController *vc = [[CapturedPhotoViewController 
alloc] initWithNibName : @"CapturedPhotoViewController" bundle : nil]; 

vc.modalTransitionStyle = UIModalTransitionStyleFlipHorizontal; 

[self presentModalViewController : vc animated:YES]; 

[vc release]; 


Ah ha! I*t ，s 3 modal vicv/ … 


*to Pile’s 0^v\tr, a*t 
{\\t dialog bo%. 


nn 


FugitiveDetailViewController.m 


iBountyHunter Qj jBountyHunter CTI iPhone # FugitiveDetailViewController.xib View Button 


D □ b ^ o 


0 Placeholders 


File's Ownfl 
• First Respoilder 


Button 


o 


State Conf 


Q Objects 


View 

Label - FugitiA Name 
Label - Fugitive ， 

Button 
Text View 
Label - Bounty: 

Label - $1,000,000 
Label - Captured? 
Segmented Control 
Label - Capture Date & 
Label 


Fugitive Name 

Fugitive ID# 


Lorem ipsum dolor sit er el it 
lamet, consectetaur cillium 
adipisicing pecu, sed do 
eiusmod tempor incididunt ut 
labore et dolore magna 


Bounty: $1,000,000 
Captured? 


Capture Date & Time: 


[O 


L 

shadow 


Color 1 


Color I 


ihadow Offset 


ra * Q. 


The m-fo button is jus*t 3 W|Butto» 
i^uv-cd m 七 k *mspcd*to\r 
w *m-Po dark" -type- 


H II Qi ♦ t iBountyHunwr 


Info Dark 

了 ) 


Default 

了 1 

| Default Title 

1 Default Image 

3 

1 Default Background Imac ▼ 

Helvetica Bold 15.0 

(t) 

i i 

Default 

了 ! 

i~~i 

- 

Default 

：) 


of? 

o y 


Width Height 

Q Highlight Reverses Dire... 
Drawing 0 Shows Touch On Highlight 

Highlighted Adjusts Image T 


D {} Q ■ 


m 


Objects 


L 


abel 


Text 


sz 




1 ^ 


函 El 腿 6 


oT 


Make suv-c you have simulated -tab ba\r m hcv-c -too, so i-t 
does / 七 jet W\ddcJ 
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long exercise solution 



ExenctSe - 

§OLutlOH 

This one is a whole bunch of functionality that you added 
without much help! Here’s what we came up with: 

o Build the new CapturedPhotoViewController (continued). 


iBountyHunter } [ iBountyHunter f [ iPhone } U Captu red Ph otoViewCo nt ro 11 ... > View ? Button - Dome 


0 Placeholders 


File's Ownet 


^ First Respon^r 


孩 Objects 


j View \ 

Image View 



r O Button - oVie 

Editing Did Ehd 

o u 

Touch Cancel 

o 

Touch Down 


Touch Down Repeal 

o 1 

Touch Drag Eeiter \ 

o 1 

Touch Drag Exil 

o 1 

Touch Drag Inside 

、 0 ■ 

Touch Drag Outside 

0 1 

Touch Up Iniide * Rle™E Owner 

daneBulifan... 

# I 

Touch Up Outside 

o 1 

Value Changed 

o 

▼ Referencing Outlets 

h 1 _ _ . 「 1 _ L _" _ _ _I™L . _ilI —. 

^ o 

k _ 4 


-Povgcl the bui;W 


Done 


H \f<x 

H || Qi iBountyHunter 
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camera, map kit, and core location 




Tesr DriVq 


Run the app and see the cool animation working! 



G ㈤ rgc Palin 
se 哪 


Pqlty (heft 


Bounty: 5flfW3 
Capturod? Yes 1 
Capture Date & Time: 






This is the ir^a^e 
view—its Cr^pty, 
but hot -rov- 


&one 



liharpen your pencil 

Now the 


Now the views and animations are all working properly, 
what about the image itself? Think about the data model 
when you fill in the blanks below. 


The Ullmage will be stored in the 




The 


and the 


need to be 


again so this will work. 


The has to know about the image and where to display it. 


The image has to come from the . or the 
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sharpen solution 


Sharpen your pencil 

Solution 


Now the views and animations are all working properly, 
what about the image itself? Think about the data 
model when you fill in the blanks below. 


The Ullmage will be stored in the 


database 




The database and the data model need to be … iyated again so this will work. 

The tu)rcdPho'to\/j C vyCoh*ty；ol | has to know about the image and where to display it. 


The image has to come from the .or the 





w 


You’ve migrated a database before, and you’re going to 
need to do it again. Just so it’s handled and out of the way, 
get into Xcode and do another database migration. 



Highlight iBountyHunter 2.xcdatamodel. 


Then go to the Editor - ^Add Model Version menu option. 

You will have iBountyHunter 3.xcdatamodel in the iBountyHunter 


.xcdatamodel directory. 



Set the current version. 

Highlight the iBountyHunter.xcmodeld directory, and select the 
File Inspector on the Utilities pane. Then in the Versioned Data 
Model section, select “iBountyHunter 3” as the Current version. 



Add the new field to the new data model 
(iBountyHunter3) and generate the new Fugitive class. 

For the image, we’ll need a new attribute called “image” that is a 
binary data type. Then delete the old Fugitive.h and Fugitive.m 
files and generate new ones via the New File menu option. 


y° u ^c sim 

do -this. 


oh 


how 
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camera, map kit, and core location 


The way to the camera... 


...is through the UIImagePickerGontroller. Why? Because our real 
mission here is to pick an image (after one is taken by the camera, 
or from a stored one). iOS implements image selection through a 
picker that allows you to get your image from different places, like 
the camera or the photo library. 


The UllmagePickerController class has a lot of built-in 
functionality, plus it’s modal, so once you implement it, a lot of 
things start happening without any additional code in your app: 


运 職㈣: 


2 
卜 

S3V C is , 3 n cd the 


s. 



j bj 

Ullmagel 

_ 




CapturedPhoto 

ViewController 


W "fVkevCo 士 0 || 饮 
tells i-fcs delegate ^ouv 

CapWdPhoWiewCo^oll^) wheh it 
? 广卞饮 4 the uw 
Ihc d , c p aic r 9^ ^ ihc s^c wav 
p:d whd 仏山 “ J 

r L hoto Uh ^y ^ iakcv, with 

the 匕 Xv^. 



UllmagePicker 

Controller 





The view 心 . 

r：, r :x 


Now it’s just a matter 
oi some syntax.*. 
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ready bake code 



k 鄉 9 Baw 

■V 

0>pe 


Here is some code you'll need to tie the image picker together. 
This code goes in our CapturedPhotoViewController.m as part 
of the exercise on the next page. 


- (void) viewWillAppear:(BOOL)animated { 

[super viewWillAppear : animated] ; o , , 

— - - - 一 七 -furtive dafwc 你 ay 

if (fugitive—.image != nil) { 払⑽ U ⑽ e. 

self.fugitiveImage.image = [UIImage imageWithData : fugitive .image] 


W\\tY\ -the v*ic>w apfeavs, display 

i-f 




- (IBAction) takePictureButtonPressed { 

CapturedPhotoViewController.m 

NSLog(@"%@", @"Taking a picture ..; 

UIImagePickerController *picker = [[UllmagePickerController alloc] 
init]; 

picker.sourceType = UIImagePickerControllerSourceTypeCamera | 

UIImagePickerControllerSourceTypePhotoLibrary; 

picker.delegate = self; __ 丁 h |S allows the usevs -fco edit 

picker. allowsEdi ting = YES; ^ 仏⑽叫 . 

[self presentModalViewController : picker animated:YES]; 

} Tk pidkev is displayed asy^^hv-ohously. 

#pragma mark - UIImagePickerControllerDelegate methods 

- (void) ImagePickerController : (UIImagePickerController *)picker didFinishPi 
ckingMediaWithlnfo : (NSDictionary *)info { 

fugitive_.image = UIImagePNGRepresentation([info objectForKey:UIImagePi 
ckerControllerEditedlmage]); 


[self dismissModalViewControllerAnimated : YES] 

^ Remove the pidkev 
and \rdcasc the pidkev object. 


[picker release] 


(void) imagePickerControllerDidCancel : (UllmagePickerController *)picker { 
[self dismissModalViewControllerAnimated: YES]; 

[picker release]; 


512 Chapter 10 












camera, map kit, and core location 



Time to get some images! Using the code for the image 
picker that we gave you, as well as some of your 
Objective-C skills, let’s get the image going. 



Import the Fugitive header file and declare a property 
for the fugitive. 

The GapturedPhotoViewGontroller needs to know what fugitive it’s 
working with. Add a Fugitive field and property named “fugitive” to 
the G apturedPhotoViewG ontroller. 



Store the image when its selected and update the 
UllmageView. 

You need to set the image information on the fugitive when the picker 
gives us an image, then make sure the UllmageView is updated when 
the view is shown. You’ll need an outlet for the UllmageView; then 
link it in Interface Builder. 




Add the code for the UllmagePickerController in the 
takePictureButtonPressed action. 

Use the code that we gave you to finish up the UllmagePickerController. 
You’ll need to say our GapturedPhotoViewGontroller conforms to the 
UIImagePickerGontrollerDelegate and UINavigationGontrollerDelegate 
protocols in order to make it the delegate. 




Add the、'Tap here to add photo’’ button. 

Using Interface Builder, you’ll need to create a button that covers the 


entire UllmageView and is then set behind it. Don’t forget to connect it 
to your takePictureButton action. 


Change the FugitiveDetailViewControllers 
showInfoButtonPressed method to set the fugitive 


v\cvi vAV>dcv ^ j 

add WtW 


You’ll need to pass the fugitive information along to the 
G apturedPhoto Vie wG ontroller when it’s created and before it’s pushed. 
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exercise solution 



ExegciSe 

SoLutiOH 


Here are all the pieces put together to implement the button. 


#import ''Fugitive .h > 


o 


Import the Fugitive header file and 
declare a property for the fugitive. 

Qinterface CapturedPhotoViewController : UlViewController 

<UIImagePickerControllerDelegate , UINavigationControllerDelegate> { 

©private 

UllmageView *fugitiveImage 
Fugitive *fugitive—; 

} 




l^cll Y\ttd 3 iy\ outlet so y/c update 
selected irnay- 


©property (nonatomic, retain) IBOutlet UllmageView *fugitiveImage; 
Qproperty (nonatomic, retain) IBOutlet Fugitive *fugitive; 


-( 工 BAction) doneButtonPressed; 

- (IBAction) takePictureButtonPressed; 

@end 



CapturedPhotoViewController.h 


@implementation CapturedPhotoViewController 

@synthesize fugitiveImage=fugitiveImage—; 
@synthesize fugitive=fugitive ; 


❺ Store the image when 
its selected and update 
the UllmageView. 


- (void) viewWillAppear:(BOOL)animated { 
[super viewWillAppear : animated]; 


if (fugi tive 一 . image ! 
self.fugitiveImage.image 


nil) { 

[UIImage imageWithData : fugitive .image]; 


CapturedPhotoViewController.m 
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camera, map kit, and core location 


o Add the code for the UllmagePickerController 
in the takePictureButtonPressed action. 


- (IBAction) takePictureButtonPressed { 

NSLog(@"%@", @"Taking a picture 

UllmagePickerController *picker = [[UllmagePickerController alloc] 
init]; 

picker.sourceType = UIImagePickerControllerSourceTypeCamera | 
UIImagePickerControllerSourceTypePhotoLibrary; 

picker.delegate = self; 

picker.allowsEditing = YES; 

[self presentModalViewController : picker animated:YES]; 


#pragma mark - UIImagePickerControllerDelegate methods 

- (void) imagePickerController : (UllmagePickerController *)picker didFinishP 
ickingMediaWithlnfo : (NSDictionary *)info { 

fugitive_.image = UIImagePNGRepresentation([info objectForKey : UllmagePi 
ckerControllerEditedlmage]); 

[self dismissModalViewControllerAnimated:YES]; 

[picker release]; 


- (void) imagePickerControllerDidCancel : (UllmagePickerController *)picker { 
[self dismissModalViewControllerAnimated:YES]; 

[picker release]; 


- (void)dealloc 


[fugitiveImage 一 release] 
[fugitive 一 release]; 

[super dealloc]; 
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exercise solution 





RciSe 

lutloii 

o 


Here’s all of the pieces put together to implement the button. 

Add the ''Tap here to add photo’’ button. 

Drag and drop the button from the Utilities panel. To keep them in the right order 
in the view, make sure the button is listed above the image view in the listing. 


► I — iBountyHunter i iBountyHu... ) L iPhone ^ CapturedP... View Button - Tap here to add a photo 



Cha 呼払 ' 七 7? c 


Change the FugitiveDetailViewControllers 
showInfoButtonPressed method to set the fugitive. 


- (IBAction) showInfoButtonPressed { 

CapturedPhotoViewController *vc = [[CapturedPhotoViewController 
alloc] initWithNibName : @^CapturedPhotoViewController^ bundle : nil]; 

vc.modalTransitionStyle = UIModalTransitionStyleFlipHorizontal; 

vc.fugitive = self.fugitive; 


— 



[self presentModalViewController : vc animated:YES]; 

[vc release] ; Wc \us*t r\ttA *to sc*t -furtive ov\ fv-ofev-t'] 

} added h> iV>e CafbAvedP^oWie'NCoir.-tv-ollev- 

FugitiveDetailViewController.m 
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camera, map kit, and core location 



TesT DriVq 


Build and run to see your new picture view in action. 


H !► o ± i iBauntyHiirler Thread 1 1 11 -[Captu redPhotoVi ewContro I le r takeP icture ButtonPressed ] 


All Output , 


Clear 


Q 


we Leone to change it and/o r distribute copies of it under certain conditions. 

Type "show copying" to see the conditions. 

There is absolutely no warranty for GDB. Type "show warranty 11 for details. 

This GDB was configured as 11 KB6_64-apple-darwin".Attaching to process 10315. 

2011-93-27 22sS3:14.2Ql iiountyilunterf 18315: ZB7] Taltinq a picture... 

2311-03-27 22: 03:14.712 iBauntyfluFi|^r[10315:207 } 本砵砵 leoninatiria p due to uncaught eKception 

InvalidArgumeFitEKception a f reason i V! Source type 1 not awailablej ) ia/l^4 - A i-L; s ^^ 3 ^? 

本啤啤 Call stack at first throw: 


■ns 


0 CoreFoundatian 

1 libobjt.A.dylib 

2 UIKit 

177 

3 iBountyflLinter 
ttonPressed] + 153 

4 UIKit 
: J + 119 

5 UIKit 

6 UIKit 

: withEvent:] + 527 


a25a9 _eKceptianPreprocess + 135 
OxOlQf&313 objc_eKception_tlirow + 44 

OK^Olf3353 -(UllmagePickerController setSaurceType: ]! + 
0 k000057c 9 - [CapturedPhotoViewCantroller takePictureBu 
0x0001d4fd - [JIApplication sendActian:ta:frofii:forEvenit 


9xS«9ad799 

3 xa^ 9 afc 2 b 


[JlControl sendActian:to:forEvent:] + 67 
(JlControl(Internal) _sendActionsForEvents 


A 

T 


ArgW It crashed! 





What’s wrong? Think outside the simulator here. 
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the iPod Touch is different 



Right! And neither do some 
iPod Touches and iPads. 

The simulator is reacting to the fact 
that you are asking for the camera and 
it doesn’t have one. But more than the 
simulator not having the camera, some 
iPod touches and iPads don’t either. 

Who cares? Apple. 


The iPhone isn't the only device using apps 

One of the things that Apple requires when you release an app is that it can 
work on all devices you claim it can, even if a particular device lacks certain 
hardware capabilities. Part of the approval process for apps is that they are 
checked for compatibility with the iPod Touch and iPad. 

All this means that you need to be aware of when your app may be straying into 
areas where an iPhone behaves differently than other devices. 


How many 
ctiHerences are 
tkere, really? 
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camera, map kit, and core location 



Paa] Puzzjc 


Your job is to take items from the pool and 
place them into the list for the iPhone, iPad, 
or iPod Touch. You may use the same item 
more than once. Your goal is to make a 
complete list of the functionality for the 
iPhone, iPad, and iPod Touch. 


iPod Touch _iPhone _iPad 


Note: Each thing from 



you are here 


519 












pool puzzle solution 



Paa] puzzjc 

Your job is to take items from the pool and 
place them into the list for the iPhone, iPad, 
or iPod Touch. You may use the same item 
more than once. Your goal is to make a 
complete list of the functionality for the 
iPhone, iPad, and iPod Touch. 



This list will 
change. 


\MoU Apple is always 

ii. coming out with new 

devices and updating 

capabilities. You need to check! 


iPod Touch 

iPod 

Runs most apps 

Video viewing 
Limited location 

Accelerometer 

Wi-Fi 

May have Camera 

V^u 仏 get some 

about lo^aiioh 
-Pv-om l/Vi-Fi. 


OYit 63 ^ 

be >ssuc. 


iPhone 

iPod 
Runs most apps 

v~dhdorv\ s-tu-r-r oh this list 一 
Video viewing would’ve -thought about 

the speaker? 

GPS 


Accelerometer 

Wi-Fi 

Cell phone 
Camera 

External speaker 
Video recording 
Magnetometer 


iPad 


iPod 

Runs iPhone and 
iPad apps 
Video viewing 

May have limited 
location 

Accelerometer 
Wi-Fi 

May have GPS 
May have 

、 Camera 

oy\ -tV^c External speaker 

Video recording 


Note: Each thing from 
the pool can be used 
more 
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camera, map kit, and core location 


There's a method for checking 


With all these little things that can be different between devices, pretty much 
every time you go to use something from the device, you need to check and see if 
it’s there. For the camera, the UIImagePickerGontroller has a method to check. 

You need to be careful to check for specific capabilities for a device, too. For 
example, we only use still image capture, but if you wanted to do video capture, 
you need to check that not only does the device have a camera, but also that it’s 
capable of video capture. If you’re trying to capture HD video, you need to make 
sure it can do that, too. For example, the iPhone 3GS can capture video, but not 
at the same resolution as the iPhone 4. 


[UIImagePickerController 

isSourceTypeAvailable : UIImagePiekerControllersourceTypeCamera] 




a souv-tc, 


d souv-tc, 

i-f i\\t souv-tc you 


In our case, we have another option: the photo library. If there’s no camera, we can 
get an image from there instead. If you’re writing an application that cannot do 
something without a camera and the check fails, you need to disable that feature 
(and potentially hide the controls so the user isn’t confused trying to enable that 
feature). If your application cannot work at all without a camera (or net access or 
accelerometer, etc.), you can specify device capabilities for your application so users 
without those capabilities can’t even install your application on their device. 




So what happens when the user taps the “Take 
a photo” button? You check for the camera, then 
what? What’s the user flow? 
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action sheets 


Prompt the user with action sheets 


Action sheets slide up from the bottom of the page and give the user options 
to proceed. It’s similar to a modal view because the user has to address the 
action sheet before she can move on to anything else. Action sheets are really 
straightforward to use: they take strings for their buttons and have built-in 
animations for appearing and disappearing. Our code for the action sheet has 
some standard stuff included: 


㈣ w 、 ⑽外 “ UIActionSheet ^photoSourceSheet = 

ved- ^ ^ [ [UIActionSheet alloc] initWithTitle : 

@〃Select Fugitive Picture" 


ov>c 


Photo* 



delegate : self cancelButtonTitle : @^Cancel' 
destructiveButtonTitle : nil _ 

otherButtonTitles : @^Take New Photo 〃， @〃Choose Existing 

,nil]; [ 

\ Pctlavc *tV>C oihev *t>wo bu*t*toy>s ar>d 

youVc doir>C- 

[photoSourceSheet showInView:self.view]; 

[photoSourceSheet release] 

^ Yes, I this 

w,11 delete all my siM. Please do butU, please 於 W 鈿 ct 

whulh is -the dcstirud-tivc button. \_ed 、 aW7, 


Pirst, allocate the ad-tioh 
sheet, 3hd pass i-t ^ -title. 

All action sheets v>ccd a 

bu*btoy^ so you dismiss i*t, 
\us*t like modal v"ic>ws. 


>wc 


Use action sheets to let the user pick the image source 

We know that our options are to use the camera, use the photo library, or 
cancel, so we’ll need to implement the behavior for each option. 


6\o *fco i\\t ddmev-a, -take a fidWc, ar\d 七 dome badk air>d 
fu 七 you^r *rn*to i\\t Furtive. Out you ha 朽 d oW *to 

UI|ma^cPidkcv-Cor>*tvollcv-Sou\rdcTYpcCa^cv-a, i*t II 
vcs*t. 



6\o *to pho-fco lib\ravy, pi^k By\ and tomt 

badk ^Y\d s*tu-r-r 七 *m*to Fugitive- 
_U||majcPidkc\rCo^*t\rollc\rSou\r^cTypcPho*toLibva\ry handles \rcs*t- 



o batk *to 七 lie ima^c view. 


522 


Chapter 10 





camera, map kit, and core location 


i^arpen your pencil 



Time to implement the action sheet. There’s a lot here to 
think about since we’re changing the flow of the app a bit. 



Implement the delegate methods for the action sheet. 

Here’s enough to get you started. Think about the options for case 1 
and the default, and make sure you release the picker and present the 
view. Also don’t forget to declare the UIActionSheetDelegate in the 
header file. 

(void) actionSheet:(UIActionSheet *)actionSheet didDismissWithB 


uttonlndex:(NSInteger)buttonlndex { 


if (buttonlndex == actionSheet•cancelButtonlndex) { 


NSLog(@"%@", @"The user cancelled adding an image."); 


return; 


UllmagePickerController ^picker = [[UllmagePickerController 
alloc] init]; 

picker.delegate = self; 

picker.allowsEditing = YES; 


switch (buttonlndex) { 
case 0: 

NSLog @’’User wants to take a new picture .’’）； 

picker.sourceType = 

UIImagePickerControllerSourceTypeCamera; 


break; 


CapturePhotoViewController.m to include the action sheet. 

iBountyHunter needs to check for the camera, and if there is one, the This is the 

user gets to pick whether to use the camera or an existing picture. If adtioh domes 

not, the app should just go straight into the photo library. 


o Modify the takePictureButtonPressed action in 



Make your code readable! 

We divvied up the implementation code into three #pragmas: the 
takePictureButton code, the UllmagePickerController code, and the 
action sheet delegate methods. 


ih. 
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sharpen solution 


^Sharpen your pencil 
^ Solution 


The action sheet should be ready to go and 
your app has a good user flow now... 


O Implement the delegate methods for the action sheet. 



CapturedPhotoViewController.h 

Qinterface CapturedPhotoViewController : UlViewController 

<UIImagePickerControllerDelegate, UINavigationControllerDelegate, 

UIActionSheetDelegate> 



- (void) acClonSheetT (UIAc€TonSheet ^ ) actionSheet didDismis 

sWithButtonlndex : (NSInteger)buttonlndex { 

if (buttonlndex == actionSheet.cancelButtonlndex) { 

NSLog(@"%@", @’’The user cancelled adding an image."); 

return; 

} 

UIImagePickerController *picker = [[UllmagePickerController alloc] 
init]; 

picker.delegate = self; 
picker.allowsEditing = YES; 

switch (buttonlndex) { 
case 0: 

NSLog (@"%@’’，@"User wants to take a new picture."); 
picker.sourceType = 

UIImagePickerControllerSourceTypeCamera; 

break; 
t 

case 1 : 

NSLog, @"User wants to use an existing picture."); 
picker.sourceType = 

UIImagePickerControllerSourceTypePhotoLibrary; 

break; 

} 

[self presentModalViewController : picker animated:YES]; 

Captured Photo 
ViewController.m 
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camera, map kit, and core location 


❻ Modify the takePictureButtonPressed action in 

CapturePhotoViewController.m to include the action sheet. 


Ch 呼 *to WtcTYfcP^o*toLiba\rY *»^ you 

y/ay\*t b> see *t^c a^tiern sV^cc*t y/ov-km^ oy\ 

simulaW. 


- (工 BAction) takePictureButtonPressed { 

NSLog @’’Taking a picture •••’’）； < •• 一 “Uov. 

if ([UllmagePickerController isSourceTypeAvailable:UIImagePickerControllerSourceTy 
peCamera]) { 

NSLog@’’This device has a camera. Asking the user what they 
want to use ； 

UIActionSheet *photoSourceSheet = [[UIActionSheet 
alloc] initWithTitie: @’’Select Fugitive Picture” delegate : self 
cancelButtonTitle : @ 〃 Cancel 〃 destruetiveButtonTitie : nil 
otherButtonTitles: @’’Take New Photo", @"Choose Existing Photo", nil]; 

[photoSourceSheet showInView : self. view]; 

[photoSourceSheet release]; 

} 

else { // No camera, just use the library. 

UllmagePickerController *picker = [[UllmagePickerController alloc] 

init]; 

picker.sourceType = UIImagePickerControllerSourceTypePhotoLibrary; 

picker.delegate = self; 
picker.allowsEditing = YES; 

[self presentModalViewController : picker animated:YES]; 



CapturedPhotoViewController.m 


Does it work? 
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test drive 




TesT DriVq 


Fire up iBountyHunter and drill down through a fugitive to the point of taking a picture. If you’ve 
used the SourceTypePhotoLibrary in the takePictureButtonPressed code, you'll get everything 
to work and see the action sheet. 



The fops uf, 

otitt you sclent diioosc 




… y ou 3 托 lauhdhed ihio the pho-to 
lib\ra\ry a^d you ^ select a phot>. 


Saved Photos 


YouV- Simula*boV* V»ll Y\o{, 

V^ave images unless you 
mstall TVic easiest 
v/ay -to do tV^at is -to dvaj 

a 灼 d dv-of fV^o-tos oy\{p 

simulaW) *b^cr\ ditk and 
Kold oh *tKcm m Sa-fav-'i 
a^di save *tKc imaje- 



Gee| Bits 


It might be time to register with Apple’s Developer Program. If you do, 
you can install the app on your actual iPhone and test it yourself. Check 
out the appendix at the end of the book to help you walk through the 
provisioning process to make it work. 
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camera, map kit, and core location 


Don’t newer iPhones and iPads 
support video now? How do I get to that? 

It’s another media type you can access 
when you use the UllmagePickerController. 
By default, it uses still images, which is what 
we want for iBountyHunter. 

What about the whole augmented 
reality thing with the camera? Can I do 
something like that? 

Yes. You can give the 
UllmagePickerController a custom overlay 
view to use if it invokes the camera. There 
are still limitations on what you can actually 
do in the camera view, but you can overlay it 
with your own information if you want. 

Q/ What’s with the allowEditing 
thing we turned on in the 
UllmagePickerController? 

The picker controller has built-in 
support for cropping and zooming images 



if you want to use it. The allowEditing flag 
controls whether or not the users get a 
chance to move and resize their image 
before it's sent to the delegate. If you enable 
it, and the user tweaks the image, you'll be 
given editing information in the callback. 

Do we really have to worry about 
the devices without cameras? 

Yes. When you submit your application 
to Apple for inclusion in the iTunes App Store, 
you specify the devices your application 
works with. If you say it works, Apple will 
test it on both types of devices. They also 
run tests where your application cannot get 
network access to ensure you handle that 
properly as well. Think defensively. Apple is 
going to test your application in a variety of 
scenarios. 

Is there any way to test the camera 
in the simulator? 

No. What we’ve done is about as 
close as you can get, which is to implement 


the code for the camera and test it with the 
photo library. You’ve learned a lot so far, and 
lots of the functionality that you’re moving 
into has outgrown the simulator. GPS 
functionality, the accelerometer, speaker 
capabilities, all of these things can’t be 
tested in the simulator, and to really test 
them, you’ll need to install them on your 
device. 

Q/ What’s the deal with Apple’s 
Developer Program again? 

In order to install an app on your 
device or to submit an app to the App Store, 
you need to be a registered iOS developer 
with Apple. The fee currently is $99. Even if 
you want to just install an app for your own 
personal use, you'll need to be registered. 

Look at the appendix for more detailed 
directions on how installing an app on your 
phone actually works. 


Let’s skow 
it to BoL •“ 
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location is important 


Pob needs the where, m addition to 
the whew 

You’ve given Bob a way to record the proof he captured 
someone with a photo, and an easy way to note when it 
happened, but what about the where? 



Cool—I love the 
pictures—but I need 
location info about the 
grab, too. 


Bob has a jurisdiction problem. 

There are rules about where Bob can nab 
criminals, so he needs to keep track of where 
the capture occurred. 

The easiest way for Bob to keep track of 
these things is by recording the latitude and 
longitude of the capture. 
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camera, map kit, and core location 


Sharpen your pencil 



How are two new fields going to affect the app? Use 
this space to show where, and on what view, the 
latitude and longitude info will end up. 


㈣ 一 



What needs to happen to the data model and the data itself? 
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sharpen solution 


Sharpen your pencil_ 

Solution 

Here’s what we came up with for the new 
view and the data changes: 


Smdc v/cVc lo>w 

加 s ? a6C rn ^ 

Y/cVc -to V ，气， 

latitude lo—We 

-to^ct^cv- 


What needs to happen to the data model and the data itself? 

The ddidbase heeds to be updated: y/cVc go'mj bo be a latitude a^d loh^i-tudc 

value \y\ dc^v-ccs. To hold -them *m *the dd*bdbdse ； *thcy1l Y\ttd to be broken up *m*to *bwo 
a*t*t)ribu*tcs ^foy ； 七 l^c Fuji.iiyc dlass ： latitude, a^di Jphgi-tudc.. 


This 
be 3 



Stealing cool names from 
other industries. 


Bounty: 23000 
Captured? 


® No i 


Capture Date & Time: 2011-03-28 +0000 

Loda*tioh ： La*t > Loh^. ❼ 


Fugitives 


Captured 


>3^ 


y 



Emmanuel Uttenburg 


23454 
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camera, map kit, and core location 


LOCATION CONSTRIJCIION 


Get into it and get the app ready for the capture coordinates: 

Implement the new fields in the view for the location 
label and the latitude and longitude fields. 



Migrate the database again and produce the new Fugitive class 
with the latitude and longitude fields. 

x ^ died thcrw 

ahd daptuircdloh av\d made 
type “Double”. 
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location construction 


LOCATION CONSTRIJCIION 

Get into it and get the app ready for the capture coordinates: 


Implement the new fields in the view for the location 
label and the latitude and longitude fields. 





FugitiveDetailViewController.h 


Add *tK*is *to 
v"ic>wlVillAffcav-. 



capturedLatLon.text = [NSString stringWithFormat : 

@ 〃％ .3f, %.3f", [fugitive.capturedLat doubleValue], 

[fugitive•capturedLon doubleValue]]; 

[capturedLatLon release]; 



FugitiveDetailViewController.m 


0 Placeholders 


▼ 


File's Owner 
First Respon 

雄 Objects 

View 

Label - Fugitive N 气 e 
Label - Fugitive ID# 

Button 
Text View 
Label - Bounty: 

Label - $1,000,000 
Label - Captured? 

Segmented Control - Yes, No 
Label - Capture Date & Time: 
Label 
Button 

Label - Capture Lat Lon: 




Fugitive Name 

Fugitive ID# 


Lorem ipsum dolor sit er elit 
lamet, consectetaur cillium 
adipisicing pecu, sed do 
eiusmod tempor incididunt ut 
labore et dolore mac 


l/Vc^vc added 
La 七 Lor> -f ield hcv-c- 


o 

▼ 

Referencing Outlets 

Label 

%- i 


capturedLatLon 

M File's Owner 



Bounty: 
Captui 


, 000,000 

置 


New Referencing Outlet 
Referencing Outlet Collections 
New Referencing Outlet Collection 


Cap 

Capture Lat Lon: 




The values will be 
-added V>cv-c 
七 he -furtive is 
dafiuvcd- 
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camera, map kit, and core location 



Migrate the database again and produce the new Fugitive class 
with the latitude and longitude fields. 


WlcVc up *to 


& iBountyHunter 

L-J 2 targets. iOS SDK 4.3 

CoreLocation.framework 
] iBountyHunter 
h Fugitive.h 
m Fugitive.m 

iBountyHunter.sqlite 
h iBountyHunterAppDelegate.h 
m iBountyHunterAppDelegate.m 


iBountyHunter 2.xcdatamodel 
iBountyHunter 3.xcdatamodel 
^ jBountyHunter 4.xcdatamodel 
[j iBountyHunter.xcdatamodel 
门 iPhone 

h iBountyHunter...legateJPhone.h 
[m| iBountyHunter...legateJPhone.m 
MainWindowJPhone.xib 
h FugitiveListViewController.h 
[mj FugitiveListViewController.m 
△ FugitiveListViewController.xib 
h CapturedListViewController.h 


ENTITIES 

FETCH REQUESTS 
CONFIGURATIONS 


Q Default 

The -f ields, 

dir>d 
da*tpuv-cdLor>, 
av-c bo*tV> o^ 
•type w Poublc w 



▼ Attributes 
Attribute 

Q bounty 
Q captdate 
Q captured 
Q captured La t 
Q captured Lon 
Q desc 
Q fugitivelD 
Q image 
Q name 


▼ Relationships 
Relationship 


Identity 


Type 
Decimal t 
Date i 
Boolean t 
Double i 
Double i 
String i 
Integer 32 ； 
Binary Data i 
String i 


Group Name iBountyHunter.xcdatamodeld 


Path Relative to Group 


iBountyHunter.xcdatamod 

eld 

Full Path /Users/Tracey/ 

Documents/HFiPhoneDev/ 

v2/chl0/app/ 

iBountyHunter-part4 / 

iBountyHunter/ 

iBountyHunter.xcdatamode 

Id 


Destination 


▼ Fetched Properties 
Fetched Property 


Predicate 


▼ Versioned Data Model 

Current: iBountyHunter 4 

0 

▼ Text Settings 

Indent Using ^ Spaces 


Widths 4]Q [_ 4^ 

Tab Indent 

0 Wrap lines 

a 


OK, so rd bet you can get 
latitude and longitude from the 
GPS on the iPhone, but didn’t you 
just warn us that iPod Touches 
and Wi-Fi iPads don't have that? 


O 


That’s true, but you’ve got 
options. 

You may remember back in that pool 
puzzle we said something about the iPod 
Touch and Wi-Fi iPads being able to 
handle limited location. iOS has more 
than one way to get at where you are in 
the world... 
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core location 


Core Location can find you m a few ways 

GPS is often the first thing most people think of for getting location information, 
but the first generation iPhone didn’t have GPS, and neither do iPod Touches 
or Wi-Fi iPads. That doesn’t mean that you’re out of options though. There are 
actually three ways available for iOS to determine your location: GPS, cell tower 
triangulation, and Wi-Fi Positioning Service. 

GPS is the most accurate, followed by cell towers and Wi-Fi. iPhones can use 
two or three of these, while iPod Touches and Wi-Fi iPads can only use Wi-Fi, 
but it beats nothing. If your head is starting to spin, don’t worry! Gore Location 
actually decides which method to use based on what’s available to the device 
and what kind of accuracy you’re after. That means none of that checking for 
source stuff; the iOS will handle it for you with the LocationManager: 



Allocate CLLotahoh 


(CLLocationManager*) locationManager 
if (locationManager— == nil) { 

locationManager— = [[CLLocationManager alloc] init]; 

locationManager—.desiredAccuracy = kCLLocationAccuracyNearestTenMeters; 

locationManager_. delegate = self; Wfc sci iht b> 

10 metev-s -fo\r Bob- 

a^^uv-ady da 的 -take lo^gcv- 


return locationManager 


Oy\tt lotatio^Ma^ajcv- 
V^as position, i*t 
s*tav-*t i*t ba^k *to 

； delegate- 

Core Location relies on the LocationManager 


b> g,c*t a a-f-fcdtmg 

o( youv app. 


To use Gore Location, you simply need to create a location manager and ask 
it to start sending updates. It can provide position, altitude, and orientation, 
depending upon the device’s capabilities. In order for it to send you this info, 
you need to provide it with a delegate as well as your required accuracy. The 
CLLocationManager will notify you when positions are available or if there’s an 
error. You’ll want to make sure you’re also properly handling when you don’t get 
a position from the location manager. Even if the device supports it, the users get 
asked before you collect location information, and can say “No” to having their 
position recorded (either intentionally or by accident). 





Where should we implement this code in 
ourapp? 
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camera, map kit, and core location 




Yes, and a new framework. 

To keep the size of your app small, Apple 
breaks apart functionality into libraries. 

As you start adding new functionality, like 
Gore Location, you’ll need to start adding 
frameworks. Since the Gore Location 
framework isn’t included by default, we 
need to add it. 
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core location framework 


Add a new framework 

It’s time to add the Gore Location 
framework to the app. Highlight the 
iBountyHunter target. Click on the Build 
Phases tab and expand the Link Binary 
with Libraries section. Then click the 
+ button and choose the GoreLocation 
framework. 


The 灼 ew 

should be \rc I orated 
*to /Fv-amcv/ovks 
-foldcv-. 


a 


then update the header file 

We still need to declare ourselves as conforming to the 
GLLocationManagerDelegate protocol and add our property: 


.、 r.xcodrproj 

Rwnnmg itountvHuntcr on ifhonc SwnuUtor 



#import < UIKlt/U mt .心 ^ — UUe 如心 CceLcaW k. 

#imp ort <CoreLocation/CoreLocation.h> 

#import ''Fugitive .h" 

: 二：二二 v: 二 ; 


CLLocationManager *locationManager 


so v/C 63 於认父丨七 3 的 (A 




@property (nonatomic, 


readonly) CLLocationManager 


★locationManager; 


FugitiveDetail 

ViewController.h 
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camera, map kit, and core location 





Your job is to be tire developer and figure 
out wheve you’re going to implement Core 
Location into our user flow. Assume that 

Bob needs tire location and 
date and time to 雕成 a 
c^ture. 


o 

❺ 


What method will be used to kick off Gore Location in the detail view? 


What happens when the location is returned to the view controller? 



What happens if Core Location can’t get anything or the user disables it? 



When will you shut down Gore Location? 



What about other devices? 



Core Location inhales batteries. 

Making frequent calls from your app to find locations will 
quickly drain batteries, since it turns on the GPS/cellular/ 
Wi-Fi receiver. That’ll lead to upset users and cranky 
iTunes reviews. Keep it to a minimum! 


you are here ► 
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be the developer solution 



BE th^ 心初改 s©|ug©n 

Your job is to be lie developer and figure O What method will be used to kick off 
out A^ere you’re going to implement Cope Gore Locatlon m the detai1 view? 

Location into our user flow. Assume 伽 The fO Core Lo^atioh dould 30 

Bol) H0eds fllG location m-to vicwW/ill/\ppcar -for -the detail View, bu*t 

date and time to mark a 丄 —， to 

ddiled v-c^resKFu^iibivc|h-jrov-ma-itioh. 

o What happens when the location is returned to the view controller? 

Well know *the loda*tior\ mahayv - 匕扣 jrt 七 he durrerrt posi-tioh. |-f 七 he user r^avks *thc -fugitive as 
dap*tu\red> we r\ttA *to yt *thc duvrerrt position -from *the loda*tioh mar\ay\r a^d update *the -fu^i-tive. 


-( 工 BAction) capturedToggleChanged : (id) sender { 

if (self•capturedToggle•selectedSegmentlndex == 0) { 

// The user just marked this fugitive as captured 
fugitive—.captdate = [NSDate date]; 

fugitive .captured = [NSNumber numberWithBool : YES] 


\Afe y^ttd 
Wmual—— 七 ，' 
lodatioy^s, so >WC ii ask 
Uaho^ ma^ayv- W its 
las 七 lodat«o^ 从 

usev *to^'c s 
七 6a?Wed 6ov^tv-ol 


CLLocation *curPos = self.locationManager.location; 


fugitive 一 .capturedLat = 
coordinate.latitude]; 

fugitive 一 .capturedLon = 
coordinate.longitude]; 

} 

else { 

fugitive—.captdate = nil; 

fugitive—.captured = [NSNumber numberWithBool:NO]; 

fugitive_.capturedLat = nil; 
fugitive_.capturedLon = nil; 

} 


J 


[NSNumber numberWithDouble : curPos. 


[NSNumber numberWithDouble : curPos. 


[self refreshFugitivelnformation] 


TWis is y>i 吒 *to 』 oumew all 

-Puytivc mtludmj ufda 七 ed 

|ota*bior\ m-fov-mation. 




FugitiveDetailViewController.m 


538 Chapter 10 















camera, map kit, and core location 


@interface FugitiveDetailViewController () 
- (void) refreshFugitivelnformation; 

@end 

- (void) viewWillAppear : (BOOL)animated { 

[super viewWillAppear:animated]; 


y/cll bo H 1 somC out ok 

w>c*t^od 3y\d vclo£.3*tc it 


[self refreshFugitivelnformation]; 

// Disable the capture toggle button until we have a location fix 

self.capturedToggle.enabled = NO; 

[self.locationManager startUpdatingLocation]; 


PI 



0 


(void) refreshFugitivelnformation { 

self.nameLabel.text = fugitive 一 . name; 

self.idLabel.text = [fugitive—.fugitiveID stringVa 

self.descriptionTextView.text = fugitive 一 •desc; 

self.bountyLabel.text = [fugitive 一 .bounty stringValue]; 

self.capturedDateLabel.text = [fugitive 一 . captdate description]; 

self.capturedToggle.selectedSegmentIndex = [fugitive 一 •captured boolValue] ? 
: 1； _ 

self.capturedDateLabel.text = [fugitive 一 . captdate description]; 

if (fugitive 一 •capturedLat != nil) { 

self.capturedLatLon.text = [NSString stringWithFormat:@ .3f, % •3f 〃， 

[fugitive 一 •capturedLat doubleValue], 

[fugitive 一 •capturedLon doubleValue]]; 

} 

else { 

self.capturedLatLon.text = @; 



FugitiveDetailViewController.m 
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be the developer solution 



n s©|ug©n 

❺ What happens if Gore Location can’t get anything or the user disables it? 


S’mde Bob heeds loda*tioh 'rn-fo y/hcr\ he marks a -fugitive as dap*tu\rcd, well 

Y\tt& *to disable *thc dap*tu\red sy/i*t^K i-f y/c y 七 


- (CLLocationManager*) locationManager { 




if (locationManager 一 == nil) { 

locationManager— = [[CLLocationManager alloc] init]; 
locationManager .desiredAccuracy = 


kCLLocationAccuracyNearestTenMeters; 

locationManager .delegate = self 


TW，s 

七 ,^ Ue 七 VU? 




return locationManager ; 


Th f. l oC ^ ioir, **>ana9ev- will 

岑 ㉗ iTu ) 二 " 


- (void) locationManager : (CLLocationManager *)manager 
didUpdateToLocation : (CLLocation *)newLocation fromLocation : (CLLocation 
*)oldLocation { 

NSLog(@"%@", @"Core location claims to have a position."); 
self.capturedToggle.enabled = YES; 


i^+oirrhatioh. 


- (void) locationManager : (CLLocationManager *)manager 
didFailWithError : (NSError *)error { 

NSLog, @"Core location can't get a fix. Disabling capture 
toggle."); 

self.capturedToggle.enabled = NO; 



•to wavrt tVic user ^ an Y onC as da ^ u，rcd， 


FugitiveDetailViewController.m 
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camera, map kit, and core location 


When will you shut down Core Location? 

IVlcll shu*t i*t dovm when we leave detail view. 


- (void) viewWillDisappear:(BOOL)animated { 
[super viewWillDisappear : animated]; 

NSLog , @ A, Shutting down core location. 

[self.locationManager stopUpdatingLocation] 


jWakc su^c you shu-t dowh -the 



FugitiveDetailViewController.m 


- (void)dealloc 

r 


1 

[fugitive release]; 


[nameLabel release]; 


[idLabel release]; 


[descriptionTextView 

release]; 

[bountyLabel release]; 

[capturedToggle 

release]; 

[capturedDateLabel_ release]; 

[capturedLatLon 

release]; 

[locationManager 

release]; 

[super dealloc]; 

} 




What about other devices? 


WcVc o^ood- All do is *tdl Core 

Loda*tioh addurady wc wa^-t a 灼 d 

i 七 deals y/i*th 七 he rest. So, iPod 


ToudK C^Y\ yt jus 七 bes-t dd*bd i*b 

a^d well yt *tha*t. 


Implement all tkis 
cocte anct tken 
take it lor a spin... 
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no dumb core location questions 


thereicire no ^ 

Dumb Questi9ns 


We start and stop Core Location in viewWillAppear and 
viewWillDisappear. Is that normal? 

It’s normal to start and stop Core Location as you need it. It 
uses a fair amount of power while it’s running, so it’s best to shut 
it down if you don’t need it. This gets a little tricky because Core 
Location can require some time to get its initial position information. 
To try to make that a little smoother for the user, we enable it as soon 
as the view appears to give it a head start before the user needs the 
location. 

Is there any way to speed up that initial position? 

Core Location will try to cache previous position information 
so it can give you something as quickly as possible. Because of 
this, if you’re really concerned about accuracy, you should check the 
timestamp sent along with the position information to make sure the 
position is recent enough for your needs. 

Does location accuracy impact things like startup time or 
battery usage? 

Absolutely. The more accurate a position you ask for, the more 
battery Core Location will consume, and it will potentially take longer 
to figure out. Lower-fidelity information tends to come to you faster. 
Use whatever accuracy you need for your application, but be aware 
of the implications of high-resolution information. 

Is there a way to just wait for Core Location to have a 
position rather than having it call back to the delegate like that? 


No. Core Location, like a lot of other frameworks in iOS, calls 
back asynchronously as data is available. Network access generally 
works this way as well. You need to make sure you keep your users 
informed of what’s going on in the application and what they can and 
can’t do at the moment. For example, we disable the Captured button 
if there’s no position information available. Other options display a 
wait indicator (like a spinning gear) or display position status with a 
disabled indicator like an icon, button, or label. 

Why did we have to move the code around and do all that 
refactoring? 

We did it to follow the DRY principle (Don’t Repeat Yourself). We 
cleaned up the code and eliminated duplication by pulling it out into a 
separate method and calling that from the two places that need it 

What’s the deal with the private interfaces again? 

Remember that our header file captures our public interface or 
API. We don’t want this internal method to be part of our API (in other 
words, we don’t want other people to call it). We still want to declare 
it so the compiler can check that we’re calling a valid method, so we 
add a Private set of methods to our interface in the implementation 
file. Some people actually put an _ (underscore) before their private 
method names so that it’s obvious that you shouldn’t be calling this 
from anywhere but the class’s own implementation. Apple, however, 
reserves this convention for their private methods. 
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camera, map kit, and core location 



TesT DriVq 


Implementing Core Location really wasn’t that hard, but making it work in the user 
flow required a bit more work. Now that it’s all done, you should be up and running... 


rB 

I Carrier ^ 10:59 AM 


Fugitives 


Peggy Ford 

45982 

shoplifting jewelry 


Bounty: 45000 

Captured? 


No 


Captured Date & Time: 2011-03-28 14:59:15 40000 


Captured Lat Lon: 38.755, -77.137 ❼ 



Smtc added ta^cdTo^lc. 
cabled NO; *to 

usev t 

C 明 c 如 CoYybro\ bcW Core 
Lot^or, starts u ? datcs. 


To 外 cerate 从 c a 代 训 1 

如 dcta-.l V\CY|, 一吐 

W.II k\tk ^ Core Lota{：^ 


All Output t 


Clear HI □ [J 



GNU gdb 6.3.50-20050815 (Apple version gdb-1518) (Sat Feb\12 02:52:12 UTC 2011) 

Copyright 2004 Free Software Foundation, Inc. 

GDB is free software, covered by the GNU General Public Lie 〜 se, and you are 
welcome to change it and/or distribute copies of it under ce\tain conditions. 

Type "show copying 11 to see the conditions. 

There is absolutely no warranty for GDB. Type "show warranty'^ for details, 

This GDB was configured as M x86_64-apple-darwin M .Attaching to 

2011-03-28 10:59:12.817 iBountyHunter[14032:207] Core location 

2011-63-28 10:59:23.518 iBountyHunter[14032:207) Core locatio 

2011-03-28 11:00:26.781 iBountyHunter[14032:207] Shutting down core location. 

2011-03-28 11:00:28.473 iBountyHunter[14032:207] Core location |S^aiins to have a position 

2011-03-28 11:00:29.263 iBountyHunter[14032:207] Core location claims to have a position 

2011-03-28 11:00:31.583 iBountyHunter[14032:207] Shutting down core location. 


dovm *to save ba*t*tcv-*ics. 


It’s working! Bot 
skoulct te psyckect. 
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bob gets visual 


Just latitude and longitude 
won't work for fob 



It’s an iPhone. A map 
would really be more 
appropriate. 

What’s the point of all the network 
connectivity and fancy graphics if 
we just show a text field? With just a 
little bit of code and the iOS Map 
Kit, we’ve got something a lot more 
appealing in the works. 
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camera, map kit, and core location 


Map Kit comes with iOS 

When Apple opened up the API for the Map Kit in iOS 3.0, 
developers gained access to the maps that come from Google 
maps, including satellite imagery. 

There’s lots of customization that you can do with the maps, such 
as how wide an area they show, what view they start with, and 
pins and annotations. 

Logistically, using Map Kit is a lot like Gore Location: you’ll need 
a new framework and will have to #import <MapKit/MapKit.h> 
in the header file. 



M^/Wapl/icw is a 乙 ohtvol 
that fulls ih-Po\rr»\a-tioh 
•(Vorw google /Waps. You 

乙如 doh-pigu\rc it -Pov- the 

^o^a\ \road display, satcllilc 

o\r a hybv-id, like you 
see 


Alap Covncs v/rth built—m 
support -Po\r pushp’ms at spedi-f ied 
lodd 七 ions，ddlled armo'tatio 灼 s. 



ov\ *b^c 

m-fov-ma*tio\r\ you 
y/ar\*t *to show on {\\t 
mdf>) you 

youv- ovm views (or 
annotations ar\d 


siioy/ you 

\N^Y\i, like pidWcs, 



Map Kit requires a network connection. 

Since Map Kit pulls imagery information from Google, 
you’ll need to have a network connection for it to be useful. 
That’s not a problem for the simulator (assuming your 
Mac is online), but it could be an issue for any device with 
limited connectivity, depending on the location. Map Kit handles this 
gracefully, but it’s something to be aware of. 


Watch it! 


How can we put 
tkis to work? 
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map custom setup 


A little custom setup for the map 

Like Gore Location, it’s not a lot of work to get basic Map Kit support 
going in iBountyHunter. We’re going to create another private method 
called initializeMapView that we’ll call from viewWillAppear in the 
GapturedPhotoViewGontroller to display the capture location on a hybrid 
(satellite plus road information) map. 


These values 
allow us "to 
^Oh-Pigu\rc tlic 
如 o? the ' 

default 
shoy/h. 



- (void) initializeMapView { CapturedPhoto 

ViewController.m 

if ([fugitive 一 • captured boolValue]) { 

CLLocationCoordinate2D mapCenter = CLLocationCoordinate2 
DMake ([fugitive 一 . capturedLat doubleValue] , Were, well pass i" the value 

# "the loh wlic\rc the 

[fugitive 一 • capturedLon doubleValue]) ; -rugi-tivc was daptuv-cd. 

MKCoordinateSpan mapSpan = MKCoordinateSpanMake(0.005, 

0.005); 

MKCoordinateRegion mapRegion = MKCoordinateRegionMake(ma 
r mapSpan) ; T ^ pull 3ll U is 

self .mapView.region = mapRegion; 
self .mapView.mapType = MKMapTypeHybrid; 


pCente: 


T"hc\rc a\rc a "few r^p types ； hybv-id is 
both satellite \ro^d ih-Po\rrha-tioh. 

L. . .1 , 如 d how hrvudh should 

r ， ap. / ^ the zoor, level 


The s\z£ of 州矸 is ’m 

dcyccs. Wc y/ar\*t *b^c 晰 af 

{p be zx>omcd *m. 
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camera, map kit, and core location 


tJiereiare no ^ 

Dumb Questi9ns 


What’s the difference between Core Location and Map Kit? 

Map Kit is about displaying a map, position-sensitive 
information, and user interface. Core Location is about getting 
you information about where you are. You can drag and drop a 
map onto your view in Interface Builder; you pass it some values 
and it just works. 

Core Location, on the other hand, returns values to the delegate, and 
you need to decide what to do with them. We’re going to take that 
information from Core Location and give it to Map Kit to show us a 
map of the capture location, for example. 


Where do all these frameworks come from? What if I want 
one that’s not on the list? 

The frameworks are included as part of the SDK. The actual 
path to the frameworks varies by version and what platform you’re 
developing for. For example, the Map Kit framework we're using is 
here: /Developer/Platforms/iPhoneOS.platform/Developer/SDKs/ 
iPhoneOS4.3sdk/System/Library/Frameworks/MapKit.framework. In 
general, you should be able to add frameworks using the method we 
described in Xcode and not need to worry about a specific location, 
but if a framework isn’t listed or you’re adding a custom one, you can 
point Xcode to the actual path. 



Implement the map to show the area where 
the fugitive was captured. 



Add the Map Kit framework and the #import. 

Add the framework just like we did with Gore Location. While 
you’re at it, make sure that you do the #import in the detail view 
to include the Map Kit header. 



Configure the photo view to show the map. 

Rather than adding a whole new view, go ahead and add the map 
to the GapturedPhotoView with the image. Resize the image and 
the button then drag an MKMapView to the bottom half of the 
view. 



Add the outlets and code for the MKMapView. 

Now that you have all the support stuff in place, go ahead and 
add the outlets and the actual Map Kit code we gave you to make 
the map work. Make sure you wire up the outlet in Xcode and 
call the new initializeMapView method in viewWillAppear. 


Resize 

bu*t*bo^ - 


...a 灼 d use *tV^c 

bo*b*tow> tVic 
viev/ -for 
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exercise solution 


ExeRciSe 


Implement the map to show the area where the fugitive was captured. 



Add the Map Kit framework and the #import. 


imewi: 


SlMapKit.framewQrk^ 

0 Core/bcatior .framework 

► ^ UlKit framework 

Jtih Fourdation.framework 

► 匚 orcC raphic&.fram e work 
h ： Coi^Data-framework 

Products 


0SB ! fe 


ttc\rcs -the May ^it 

-Pv-amcv/ovk... 



#import <MapKit/MapKit.h> 


Qinterface CapturedPhotoViewController : 
UlViewController <UIImagePickerControllerDelegate, 
UINavigationControllerDelegate, UIActionSheetDelegate 〉 


Qprivate 

UllmageView *fugitivelmage 
Fugitive *fugitive—; 

MKMapView *mapView 


o 



Add the 
outlets and 
code for the 
Map Kit. 

©property (nonatomic, retain) IBOutlet MKMapView 
*mapView ; 

<1 

CapturedPhoto 

ViewController.h 
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camera, map kit, and core location 



Configure the photo view to show the map. 
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exercise solution 




Add the outlets and code for the MKMapView. 



- (void) viewWillAppear : (BOOL)animated 
[super viewWillAppear:animated]; 

if (fugitive 一 •image != nil) { 

self.fugitiveImage.image = 
imageWithData : fugitive .image]; 


ihCh 7 ^ Ull^a c 

㈨ 吵 view. 


oy\ our 


[UIImage 


[self initializeMapView]; 
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camera, map kit, and core location 


Mpl/iew: Ccy^ Cd ^° h ^9 u ^ 


- (void) initializeMapView { 

if ([fugitive 一 •captured boolValue]) 

CLLocationCoordinate2D mapCenter = CLLocationCoordinate2 
DMake([fugitive—.capturedLat doubleValue], 

[fugitive 一 •capturedLon doubleValue]); 

MKCoordinateSpan mapSpan = MKCoordinateSpanMake(0.005, 

0.005); 

MKCoordinateRegion mapRegion = MKCoordinateRegionMake(ma 
pCenter, mapSpan); 

self.mapView.region = mapRegion; 
self .mapView.mapType = MKMapTypeHybr id; 





Tesr DriVq 


CapturedPhotoViewController.m 


Go ahead and build and run the app. You'll need to make sure that you mark a fugitive 
as captured, and that the lat/lon field fills in, then flip over the view to look at the map. To 
try out the zooming on the map, you’d use the “pinching” motion on a real device. In the 
simulator, hold down option and then click. 
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test drive 



Tesr DriVq 


To try out the zooming on the map; this is the “pinching” motion in 
real life. In the simulator, hold down option and then click. 


■ Carrier ? 9:52 PM P-B 



v/ou 6l'»6k 
i\^t a^d 
w ovc \i avou^d- 


TV^c simulaW ?ulU 70 UV- 
UaW based 

kor 70UV 


Excellent! Now all we neect 
is a pin to skow wkere tke 
capture kappenect. 
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camera, map kit, and core location 


Tihcssc 

Awwotatiows require a little more^^ 

Annotations are the little flags that come up when you see a point of interest, 
represented by a pin. The catch? Incorporating annotations means conforming to the 
Map Kit annotation protocol. Map Kit uses an annotation protocol so that you can 
use your existing classes and provide them directly to Map Kit. The downside is that 
means we need to add code to our Fugitive class: 


#import <Foundation/Foundation.h> 
#import <CoreData/CoreData.h> 

#import <MapKit/MapKit.h> 


Qinterface 
Qprivate 


Fugitive : NSManagedObj ect <MKAnnotation> { 


Qproperty 

(nonatomic. 

retain) 

NSDecimalNumber * bounty 

Qproperty 

(nonatomic. 

retain) 

NSNumber 

女 

captured; 

Qproperty 

(nonatomic. 

retain) 

NSData * 

image; 

Qproperty 

(nonatomic. 

retain) 

NSNumber 

女 

fugitivelD; 

Qproperty 

(nonatomic. 

retain) 

NSDate * 

captdate; 

Qproperty 

(nonatomic. 

retain) 

NSString 

女 

name; 

Qproperty 

(nonatomic. 

retain) 

NSString 

女 

de s c ; 

Qproperty 

(nonatomic. 

retain) 

NSNumber 

女 

capturedLat; 

Qproperty 

(nonatomic. 

retain) 

NSNumber 

女 

capturedLon; 


©property (nonatomic, readonly) CLLocationCoordinate2D 
coordinate; 


欠 iS 。如 ih 


(NSString *) title; ^ 9^* These 

(NSString *) subtitle; 


二 d It^ e £^ d 





Fugitive.h 


If you use automatic NSManagedObject 
file generation again, you’ll wipe out 
these customizations. 


Watch it! 
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annotation protocol implementation 


Fully impIcmcHtthG awwotatiow protocol 

The protocol requires us to have a coordinate property, a title, and a subtitle. Instead of 
synthesizing that coordinate property, we’ll implement it ourselves and just return the 
fugitive’s position, name, etc. 

For an application in which you expect to have to do more data migration, you should 
implement a separate class conforming to the protocol that has a reference to its Fugitive 
(composition) rather than adding code to the Fugitive class directly. 








- (NSString *) title { 
return self.name 


- (NSString *) subtitle { 
return self.desc; 


Fugitive.m 
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camera, map kit, and core location 



Da this! ^ 


Go ahead and add the code from 
the previous page for the Fugitive.h 
and Fugitive.m files. Then add 
the bolded code below to your 
CapturedPhotoViewController. 


/•f wc have a \ a i / | 0h ^ 

wc add the 
-(■ugitivc as ah ahho-btioh 
oh ihe map. Wc tayy do 

"this sihde -Pu^i"tivc 
how doh-fovms -to the 
^I^Ahho-ta-tioh pVo-to^ol. 



if (fugitive—.image 

self•fugitivelmage•image = [Ullmage 
imageWithData : fugitive .image]; 



if (fugitive—•capturedLat 

[self. mapView 
addAnnotation : fugitive 

} 

[self initializeMapView]; 


CapturedPhotoViewController.m 
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iBountyHunter works! 




TesT DriVq 


That’s it! Everything should be working now. You may not have 
noticed as you’ve been working through all this code, but this 
app is huge and awesome! 



mm 

■ Carrier ? 10:17 PM P| 


Captured 


Emmanuel Uttenburg 
George Palin 
Peggy Ford 


Fugitives 


Captured 
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camera, map kit, and core location 



Peggy Ford 

459B2 


This is *tV>c 


Y\t^i 

3ir>ir>o*tatior> 
todt you 
added- 


Oownty: 45000 


Ciiplumd? 


Captured Date & ]wnt. 2011 C 3 29 0UI 60 
Captured Lat Lon: 38.755 


.■77.137^^) 


Shop lifting jewelry. 



Caocel 


Tap 


here 




ph^to 


T nkc 


New 


Photo 


This mvokes *thc dameva, 
^\\\cM you car\ see or\ youv- 
y>o*t s"imula*to\r. 


AfA 


Cafrtw 令 


5:27 AM 


Photo Albums 



旮 : 2 A AM 


ciKii ( Move and Scale 
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bob approves 


That app is awesome. Were 
going to have a beautiful 
future together... 


o 


Now, how about that iPad 
app? rm ready to get into 
some more research. 
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Addin^Funetiomlity cross 

Time to flex the right side of your brain again... 



Across 

2. UllmagePickerController gets images from the_ 

and the library. 

4. The_animation comes with UIKit. 

6. The info circle is just a configured_. 

7. Additional_are needed for MapKit and 

Core Location. 

9. Your app must be able to work on the_ ， too. 

10._sheets area good way to get a user to pick an 

option. 


Down 

1. The camera cannot be tested in the_. 

3. The iPhone isn't the only_that uses apps. 

5. Besides GPS and cell towers,_can be used 

to determine location. 

8._doesn't work without a Net connection. 
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addingfunctionality cross solution 



Addin^Funetiomlity cross 

Solution 


Time to flex the right side of your brain again... 



Across 

2. U11 magePickerController gets images from the_ 

and the library. [CAMERA] 

4. The_animation comes with UIKit. [FLIP] 

6. The info circle is just a configured_. 

[UIBUTTON] 

7. Additional_are needed for MapKit and 

Core Location. [FRAMEWORKS] 

9. Your app must be able to work on the_ ， too. 

[IPODTOUCH] 

10._sheets area good way to get a user to pick an 

option. [ACTION] 


Down 

1. The camera cannot be tested in the_. 

[SIMULATOR] 

3. The iPhone isn't the only_that uses apps. [DEVICE] 

5. Besides GPS and cell towers,_can be used 

to determine location. [WIFI] 

8._doesn't work without a Net connection. 

[MAPKIT] 
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camera, map kit, and core location 



Your Location Toolbox 

You’ve got Chapter 10 under 
your belt and now you’ve added 
the camera，Core Location, and 
Map Kit to your toolbox. 


pli? •。於 

Comes 七 . 

|s 七 ^ m-tcr-fadc utilrb/ 

oy \ iP^oy\C- 

Is usually *»m\>lcmc^cd as a modal 


View. 


Comes with i^s. 

d hew 

， be dus-tomiz^d a vwty 
views, ihdludih^ push pi h 
^hhotatiohs. 


3i 

I s Messed th\rou3h the 

w " i^a3cPidkc\rCoht^ollc\r. 

卜 hot Oh all devils ahd you heed 
*W> h^hdlc that 

Allows you h> St\tti 3 hd edit ah 

' ma 9 c ^ usc yo^ app di^tly 
4 *V"om you\r libv^y. 



Cove Lotatio^ 

Car. use c*.^cr 6i?^ dell W'r 
V.a^lat»o^ or IAA - 朽 ?os*,t ， o^^ 

SCV"V*ldC- 

Chooses U you ▲十 ^od b> 
use based oy\ *tV^c usev- s dcv*»6c- 


oi md@ 
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11 !Pad UI 


考 Natural interfaces ♦ 

餐 



The iPad is all about existing in the real world. 

We’ve built a basic iPad port of an existing app for DrinkMixer a few chapters back, 
but now it’s time to build an interface that works with some real-world knowledge. By 
mimicking things that people use in the real world, users know what to do with an interface 
just by opening the app. We’re going to use some real-world elements to help Bob catch 
the bad guys... 


this is a new chapter 563 





time for some research 


Pob needs that iPad app, too... 

The iPhone app is up and running and things are great. His on-the-run 
scenario is handled, but Bob also has some research to do and that isn’t going 
to be comfortable on his iPhone. 



You have to get in the fugitives mind. 

It*s a painstaking process. Research is key to 
determining patterns, establishing relationships, and 
then predicting what they II do so you can catch them. 


This is a different use case. 

Bob is going to be sitting down, doing some 
research, coming up with a plan to track the 
fugitive. 

iPads are used much more frequently for this type 
of interaction: an extended period of usage time 
and with broader functionality. Keep this in mind 
as we work through building the app. 



iPhones and iPads are not used the 
same way. 

While there are cases where you’re using similar 
apps on both devices, often the data is going to be 
consumed differently. 
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iPad Ul 


m add 
*Puh K, 
"touches. 


The map 

will show 

the last 

khovm 

lodatioh -Pov- 
thc -Pugit ivc- 


TW t sU^a I? ^^ 

dcs\^d 


iCV" 


o 


Pad App 


To siiov/ *t^c l»s*b oi 
-fugitives, ^it\\ V^avc a 
popovcv- i\\ai a^fcav 
m *tW»s dov-nev- y/’rtii 七 Wis 

-full list 


此⑽咖加 %itive was doing 


❺ 


there. 


For research, Bob needs the fuJJ 

n e h fugitive Picture 
d detaiJs ^ouJd all be in the 
same view. 


Fu^i-tivc hfame 


o 


|rv»a^c <Jc -the Fu^i-ti 


Punitive |D# 


Dourrty ： 


廟 the information he 
iPhone app， too 


uses in the 
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This av-ea is -fov 


ho-tcsanddrtails 
about the -fu^i-tive 


Ma\> of fvcviously 
knovm lodd'tions 


IA/Ken Bob seletls a» en-bv-y ； 
a Te ， \/ie| 

desdv-ibm 

•fov *tV 


pov- the Idhdsddfe view, 
well have -the -Pull lis-t o-f 
-Pugi-tivcs displayed, si^e 
have c^i\r3 spa^c- 
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Move IXI Jood^css—dool 

bad<you 灼 d 

looks like 3 ^ov-kboa\rd 
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people know how to use things 



Why are we wasting all 
this time on a custom UI? 
Can’t we just use regular 
controls again? 


We could, but it’s not ideal. 

DrinkMixer worked fine, but it missed out on 
a lot of what makes iPad apps easy to use. We 
simply ported our minimalist iPhone UI to 
a bigger screen. While that was fine for what 
we wanted to do, it’s time to step it up to what 
the iPad is really good at, which is making 
interfaces that are closer to the real world. 


Natural user interfaces make things more real (and easier) 

One of the reasons that the iPad, and tablets in general, have been so successful is due to 
their ability to take on the form factor of lots of things that we regularly use in the real world. 
Books, calendars, menus, clipboards, newspapers, magazines, control panels, dials, and 
displays — they can all be replaced with the right interface in the tablet form factor. 

Natural user interfaces (NUIs) is a broad term that means any computer interface that 
tries to mimic more closely the way we interact with objects in the real world. Beyond multi- 
touch tablets, Wii uses a gesture recognition in 3D, and Kinect reads body movements to 
control the system. All these interfaces have exploited the way we already know how to play 
sports or other games in the real world to allow us to quickly adapt to their apps. 

Tablet computing and iPads in particular strive to do the same thing. By leveraging the 
knowledge that users already have — how to read a book, use a calendar — NUIs make using 
an app easier and the learning time shorter. 
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iPad Ul 


iOS Hlft user experience guidelines 

The HIG is a great starting point for user experience (UX) considerations for the iPad. 
The iOS Human Interface Guidelines — User Experience Guidelines, and the Case Studies 
section in particular, are full of pointers about what to do and not do. There is a great 
example of migrating mail from iPhone to iPad. The main thrust of moving an app from 
iPhone to iPad? Realism. 

TVic dc*ta'»l v 比 … jus 七 
V^as basics. 


I,— y Carrier 令 4:30 PM 


Mailboxes 


Inbox 


(3) 

Edrt 



Inbox ⑶ 1 Of 27 

9:39 AM 

> 

sick today, but can 


From: Elaine > 


All bundled up 

January 9, 2007 8:56 AM 



Just wanted to let you know we’re 
both fine. It’s freezing here—I'm glad 
you made me take the blanket 
(Emily is tq 



Ty/o »PWe avc 
6olla\>scdi *to OYkt 


vicv/. 


Co^voli^ 紐⑽ 
i\\t 


丁 k subtle -touches doh't 
dis-tv-a^t the usev-. 



It’s about realism and details 

When you read about iPad design, the HIG is full of references to “stunning graphics” and 
‘adding physicality and realism.” As you design your own interfaces, with increased real 
estate and expected time of interaction with the user, it’s important to keep in mind subtle 
things that you can add that increase the appeal of your app. It’s also partly why iPad apps 
have a greater value to the user, which means you can charge more! 


Let’s 

apply 

tkis to 

iBounty 

Hunter.. 
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ill needs planning too 


Iterate your mtcrfacc, too 

Most developers are familiar with iterative development for software but for some 
reason don’t apply those same practices to user interfaces. User interfaces, possibly 
more than any other part of an application, need real user feedback. 



PWiI sketches ahd 
wiv-c—Pv-amcs ah 

i^po\rtah-t pav-t o-f 
"the IXI dcsi^h p\rodcss ； 

but K^othihg takes the 
of \rC3l—v/o\rld 

usage- 



This iterative approach to user interface design is why taking advantage of natural 
user interfaces when possible is so important — the designers of those interfaces 
(and users themselves) have spent a lot of time going back and forth fine-tuning 
how people interact with them. By incorporating natural UIs into your application, 
you can take advantage of all that refinement and preloaded user knowledge in 
your application. 

Sketches and wire-frames are a critical part of user interface design, but before 
you pull out your pencil and start drawing, you need to put thought into what 
exactly is important to your user. 

A critical part of user interface design is determining what needs to be left out. 
Some user interface elements only make sense in certain contexts; other elements 
just confuse things and clutter up the user experience. A good, clean design like 
iBountyHunter is important. 
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Jim: I’m confused. Is this a custom UI, or are we using 
standard controls? 

Frank: Really, it’s both. 

Joe: What? 

Frank: When you’re working with iOS, most apps are 
a blend of standard controls and custom interface, and 
that’s what we’ll do. 

Jim: Oh, so the Split View Controller is still ok? 

Frank: Yes. We still have a hierarchical data structure 
we’re working with, so that works for us, but we need to 
add more detail for Bob to be able to do his research. 

Joe: OK, I guess that makes sense. 

Jim: So, what’s the strategy for building this thing? 

Frank: We need to start with the overall app structure. 

So we’ll build the Split View Controller first, then get the 
views to work properly, and then we’ll add the realism. 

Joe: What are we adding again to make this realistic? 

Frank: We’re going to add a corkboard feeling, make the 
borders on the map and photo thicker, a pushpin, stuff 
like that. 

Jim: OK, I see. So that will make it easier for Bob to 
digest what’s going on. 

Frank: Right. Now, for the split view... 
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we know how this works 


PouwtyHuwtGrHP is based on a Split 
View Controller 


Just like we did with DrinkMixer, we’re going to add a Split View Controller, 
and then modify the basics to add a detail view. 


Unlike DrinkMixer, we’re not going to be reusing our detail view from the 
iPhone app. The overall structure of the app means that we’ll be working with 
the same data and some of the same controls between the iPhone and the iPad, 
but when it comes to the views, we’re going to be keeping things separate. 

This is pretty typical of real-world apps. Often you start with a given data set 
that then needs to be applied to different use cases. This is especially true when 
you’re talking about augmenting a website or existing backend framework with 
an iOS or mobile component. 


Your work is really about effectively providing data to the user and setting up 
the interactivity for each use case. For iBountyHunter on the iPad, Bob needs 
to do some research. 

— Well y/dlk you -tKvou^K -tKe 
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these magnets o \ u xSp^- it 
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Change 
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Since you’re such a pro at getting split views set up, we think 
you should skip some steps. Go get the iBountyHunter iPad 
starter code at www.headfirstlabs.com/books/iphonedev. Here’s 
what the new code will contain for you: 


, a CoAt 

② t 。一、、 r 一一 

心::二一一 

A . 一 # 


Was 一 ，: 


/( youVc 


*to t 
klrush up.. 


卜 4 *to ^hdp-tc^* e^{o 


tr" . 以 “ 鉍 rt 

, a ^arated 心、 0 :.々 . ^ 枷 
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tQ 
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test drive 




TesT DriVq 


Go ahead and run what we’ve given you so you know where we are. 


l\si is 

^cd up 

SO 

•士 s popubicd. 


Fugitives 

Ameilla Bones 
DavW Adams 
Emman<u«l l/tieriburg 
Fiona Wes_ 
large Pfllin 
Henry Lewis 
Hunler Sweeney 
I. StQl eri 
J&ckson Jones 
Jennifer Ma« 

Jim McCsrthy 
Jim Smiley 
Joe P»nl«ls 
John Irahla 
Julie Gornnsn 
Kate Baines 


Dossier 


TWis is -bV^c s^>o-t (or 


L&»cn Ipeurc dQlQi? alt vr •eiic 
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^vav'k 





Joe: How are we going to populate this detail view? 

Frank: Just like we did in the iPhone version, I’d think, but we 
should probably break things into a couple of separate methods. 

Jim: Why? 

Frank: Well, we have a lot to manage here. There’s that map view, 
the image, and the text that all need to be updated. 

Joe: Oh right, and that map view needs a decent amount of setup, 
right? 

Frank: Exactly. Plus, remember that with the Split View 
Controller, we don’t re-create the view for each fugitive. 

Jim: Right. We need to be able to update the view when a fugitive 
is selected, not just when viewDidLoad kicks off. 

Joe: OK, so what’s the plan? 

Frank: We need to implement a couple of methods on the detail 
view to populate the description, the images, etc. 

Joe: OK, that makes sense. 


r <^jarpen your pencil 


Implement four new methods in FugitiveDetailViewController.m. 


Create a private method called prepareFugitiveDescription that returns a string 
containing all the vital stats for our Fugitive: name, bounty, and description. 


Create a private method called prepareMapDescription that returns a string 
containing all the information for the fugitive’s last known locations. 


Create a private method called updateDossier that uses our 
prepareFugitiveDescription and prepareMapDescription and sets up the image, 
description, map, and pop over. 


Finally, we need one method to pull everything together: the public 
showFugitiveDossier method. This sets the current fugitive and then calls the 
updateDossier method and dismisses the pop over if it’s visible. 
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sharpen solution 



Implement three methods to update 
FugtiveDetailViewController.m. 


Qinterface FugitiveDossierViewController () 

- (void) updateDossier; 

- (NSString *) prepareFugitiveDescription; 
- (NSString *) prepareMapDescription; 

@end 


#pragma mark - Helper Methods 


FugitiveDossierViewController.m 


- (NSString *) prepareFugitiveDescription { 

return [NSString stringWithFormat : @ A, Name : %@\r\nID : %@\r\ 
nBounty : %@\r\nDescription : %@”， 

fugitive— • name r 

[fugitive 一 •fugitiveID stringValue ], 

[fugitive 一 .bounty stringValue], 
fugitive .desc]; 


- (NSString *) prepareMapDescription { 

return [NSString stringWithFormat : @〃Last Seen : %6.3f,%6.3f\r\ 
nDescription : %@〃， 

[fugitive 一 •lastSeenLat doubleValue], 

[fugitive 一 •lastSeenLon doubleValue], 

fugitive .lastSeenDesc]; 


- (void) updateDossier { 

if (fugitive 一 •image != nil) { 

self.fugitivelmageView.image 
imageWithData : fugitive .image]; 


[UIImage 
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iPad Ul 


fugitiveDescription_.text = [self prepareFugitiveDescription] 
mapDescription .text = [self prepareMapDescription]; 


CLLocationCoordinate2D mapCenter = CLLocationCoordinate2DMake([fugiti 
ve_. lastSeenLat doubleValue], 

[fugitive 一 •lastSeenLon doubleValue]); 

MKCoordinateSpan mapSpan = MKCoordinateSpanMake(0.005, 0.005); 
MKCoordinateRegion mapRegion = MKCoordinateRegionMake (mapCenter , mapSpan); 

self. mapView. region = mapRegion ; 
self .mapView.mapType = MKMapTypeHybrid; 



if (popOver 一 != nil) { 

[popOver dismissPopover Animated : YES] 


(void) showFugitiveDossier : (Fugitive *)someFugitive { 
self.fugitive = someFugitive; 

[self updateDossier]; 


FugitiveDossierViewController.m 

TV -fL 0 cT Now you just need to call showFugitiveDossier when the device is an iPad, and the user 

taps a row. Here’s the code: 



- (void) 

tableView : (UITableView *)tableView didSelectRowAtlndexPath:(NSIndexPa 


th *)indexPath 


if (UI_USER 一 INTERFACE 一 IDIOM () == UlUserlnterfaceldiomPad) { 

[self.dossierView showFugitiveDossier : [items 一 
objectAtlndex : indexPath. row] ] ; 

} 

else { 



FugitiveDetailViewController ^detailViewController = 

[[FugitiveDetailViewController alloc] initWithNibName : @^FugitiveDetailViewControll 
er 〃 bundle : nil]; 

detailViewController.fugitive = [items— objectAtlndex:indexPath•row]; 

[self.navigationController pushViewController : detailViewController 
animated:YES]; 

[detailViewController release]; 



ugitiveListViewController.m 
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test drive 




TesT DriVq 
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iPad Ul 



before. What do we need to work on next? 


Fo\r *tKc Idhdsddpe view ； we ll h3vc "tKc 
-full list o( -fugitives displayed, s\y\U \w 
Have c^tv-a spade. 
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no dumb questions 


tJiereicire no o 

Dumb Questions 


We still have a few issues in the 
code; for instance, picking a fugitive 
without a last known location shows 
"null.” Are we going to fix those things? 

Yes, we’ll definitely fix some of them as 
we clean up the Ul, but some we’ll leave for 
you to either put on some finishing touches 
or add new functionality. 

You called a method private earlier. 
Is it really private? 

Sort of. By putting it as a class 
extension at the top of the implementation 
file, we aren’t declaring the method to be 
part of the public interface, meaning people 
who might look at our class’s header file 
won’t see the method there. However, 
there’s nothing preventing someone from 
actually trying to invoke the method if they 
knew it existed. So, from that perspective, 
it’s not really private as much as “unlisted.” 

Isn’t all this “Natural User Interface” 
stuff just a new way of saying "eye 
candy ”？ 

No, most definitely not. Sure, by 
moving to more natural user interfaces, 
you generally improve the look and feel 
of an application, but that’s almost a side 
effect. You make assumptions about how to 
interact with things in the real world all the 
time. For example, you generally want to 
pull on a handle but push on a touch plate 
on a swinging door. You probably assume 
that turning a dial to the right will increase 
whatever it is you’re adjusting while turning 
it to the left will decrease it, etc. With the 
larger and high-quality display on the iPad, 


you can incorporate these concepts into 
your application and bring an immediate 
familiarity to it. If you’re writing a calendar 
application, don’t assume that you should 
(or even can) reinvent how people want 
to view their calendar. Take advantage of 
established “user interfaces” in day planners 
and wall calendars—they've been around 
a lot longer and have had lots of time to 
geU^A/iwg evolve. 

Wait—so if I’m supposed to 
incorporate things people are used to, 
doesn’t this depend on who the people 
are? 

Absolutely! That’s a really subtle but 
important point. By incorporating familiar 
interfaces and real-world analogs, you can 
take advantage of existing user knowledge, 
but you’re relying on the user having that 
knowledge to some extent. If you target an 
international audience, you need to keep 
each audience in mind when you localize 
your application. For example, if one group 
of users’ paper calendars always start on 
Monday (versus Sunday) and you’re trying 
to mirror the paper calendar look, getting 
the starting day wrong can be pretty jarring 
(and break the very familiarity you’re trying 
to achieve). 

I’ve meant to ask this for a while, 
but is stuffing images in the database 
really a good idea? 

For our application it’s OK because it 
simplifies things, but in general you might 
want to go with something a little more 
scalable. One option is to have the image 
wrapped in its own Core Data entity that’s 
lazy-fetched rather than part of our main 


Fugitive entity. An even better option is to 
store the image on the file system and just 
keep a URL (path) to it in the Core Data 
entity. Neither of these approaches would 
be major changes to what we’ve done so far 
but would give you better scalability as the 
number (and size) of the images grow. 

Is it normal to come back and 
do the Ul after you’ve implemented 
functionality? 

It’s normal to come back and theme 
the Ul after you have functionality in place, 
but you definitely shouldn’t leave the rough 
Ul work until the end. Things that seem like 
neat Ul “innovations” turn out to be really 
difficult to use or annoying after the first few 
minutes. It’s also very common to realize 
that you really want Functionality X to be 
“right here” while you’re using Functionality 
Y. Something that was just two taps away 
now seems very distracting to constantly 
move in and out of views to reach. These 
are the kinds of things that are difficult to 
find without working prototypes of the Ul 
and really can't be put off until later. Styling 
a navigation bar with a leather texture can 
wait— figuring out the basic Ul flow through 
critical use cases can’t. 

How come we aren’t using any 
detail indicators in the table view? 

Good question! Since pushing the 
detail view doesn’t involve changing views 
in the iPad, we aren’t going to have a 
disclosure indicator. Remember, disclosure 
indicators mean that there is another view 
that will displace the current one. Since the 
table view list isn’t going anywhere, it isn’t 
appropriate. 
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The app works 
great! Now we need to 
add the custom stuff, 
right? 


Yes! 

The app works, everything updates, and now 
it’s time to add the UI on top. This is going to 
add that touch of realism that makes the app 
easier to use and takes advantage of the iPad’s 
capabilities. 


We also need to do something about what 
happens when there isn’t any data — empty map 
views and image views don’t look very good. 


Pull it all together 

When we first sketched up a view, we said that we 
needed some “UI goodness” and had a couple of 
ideas about what that would mean, like a corkboard 
background, for instance. 

One important thing to realize is that a lot of 
what we’ll do here is styling. That’s important, and 
will make a difference, but on more complicated 
applications, you need to think not just about how 
things look, but how users will interact with your 
application. We’re giving our UI a natural look, but 
for bigger applications, you need to think about a 
natural feel too. 

To make this app really look good, all those added 
elements need to work together, and they’ll work to 
create a theme. 
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one for all 


Unifying the custom stuff 


More than just adding some touches of realism, like we talked about with NUIs, we’re 
going to put together a unified look, or theme, for the app. A UI theme consists of 
fonts, images, colors, and backgrounds that all work together to create a consistent look 
for an app. 


Look and feel goes beyond just images and colors, though. Smooth animations, 
transitions, etc., all play a role and need to be consistent with the look and feel 
you’re trying to achieve. For example, using a page curl transition when you’ve styled 
everything to look like brushed metal with steel rivets isn’t going to look cool or seem 
intuitive. It’s going to look and feel wrong (most likely, the developer just figured out how 
to do page curls and wanted to throw them in somewhere!). 


have 



Creating a consistent look and feel is also where you’re likely going to start to need help 
App development can be a profession, and while you can work with some small apps 
on your own, adding final polish may require some design help. For our purposes here 
though, using the real-world analog of pushpins on a corkboard and an appropriate 
font will be enough for iBountyHunter. 


Notebook pafcv* 
-Pccl'mj 


Ou\r ba^kgv-ouhd 


Push\> 






Ouv sf/ - 吒 
U. Looks l»kc 

3 切•如矿 
bolded 七 c% 七 “ 


Pla^oldcv- ways 
plates... 




Download the four images you’ll need for the theme. Go to 
www.headfirstlabs.com/books/hfiphonedev and download 
corkboard.png, RedPushPin.png, question_mark.png, and 
silhouette.png. 
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First, we’ll start by setting up the placeholder images and the background 
image with a little code. 

Set the background image in code. 

You probably noticed that the image for the corkboard is way too small 
to fill up a whole screen. We’re going to write a little code to set the 
backgroundGolor, which in this case will be a pattern based on our 
corkboard image, like this: 


tw»s m 

\f\^Co^broWt^ 
\\\t- 


UIImage *backgroundTexture = [UIImage imageNamed : @corkboard. 
png”]; 

UlColor *backgroundColor = [UlColor colorWithPatternlmage:bac 
kgroundTexture]; 

[self.view setBackgroundColor : backgroundColor ]； 


Set the fugitive placeholder image. 


FugitiveDossierViewController.m 


Since the dossier view is just displaying an image, we need to handle 
which image is shown if the database entry is empty. The code needs to be 
changed to display the default image only if there isn’t another image from 
the database: 



FugitiveDossierViewController.m 


Set the map View placeholder image. 


The map View doesn’t display an image at all right now, so you’ll need to 
add an image View called mapOverlay on top of the map View in the GUI 
editor, and then set the image the same way you set it for the fugitive. 
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exercise solution 


EjcefictSe 
&>LutvoH 



First, we’ll start by setting up the placeholder images and the 
background image with a little code. 


Set the map View placeholder image. 



The map View doesn’t display an image at all right now, 
so you’ll need to add an imageView called mapOverlay 
on top of the map View in the GUI editor, and then set 
the image the same way you set it for the fugitive. 
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If you create a new fugitive without an image 
or map information, does your new code work? 
What about for old fugitives? 
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iPad Ul 



O 


The question mark image is always on top. 

When we created the new image View in Xcode, we put it 
on top of the map View. But we only want the image View 
to be the top visible layer if there isn’t any map information. 

If you’re not used to working with graphics programs for 
layout (including those to build GUIs), there is a concept at 
work here that we need to point out. 

Graphics programs work with the concept of layers. That 
means you can lay images on top of each other, and they 
can be completely hidden, partially hidden, or partially 
shown. Views work the same way. Each view can have 
multiple subviews stacked (layered) in a specific order. 

In iBountyHunter, when there is map information, we need 
to hide the image View. We can do this in code. 



\ y \ tKcsc 

*t>wo Ime uf. 




Tqst DriVQ 


Add the bolded code to FugitiveDossierViewController.m inside the 
updateDossier method to get the imageView out of the way depending on 
whether we have map information. 


ihis Code 
'^sidc the 
u pda*tcDossicv 
^odt h> -Pix -the 
。败 by issues 



FugitiveDossierViewController.m 
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test drive 



TesT DriVq 


Add the bolded code to FugitiveDossierViewController.m inside the 
updateDossier method to get the imageView out of the way depending on 
whether we have map information. 



6jo a^cad 
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Fugitives 


Dossier 
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This is 

looking good, but 
what about formatting 
the text and the notebook 
paper with the push pin? 


I^cwcwbcv *bW»s?_ 


A dossier- 

type font 






















iPad Ul 


It seems we have a problem... 

UITextView has some limits. Go into Xcode and highlight one of the UITextViews, 
then you can see what changes you can make. Among other things, you can change 
the font type: 


you c.air\ set 
tyfC) tolov-, 


SIZjC- 


Lorem ipsum dolor sit er elit 
lamet, consectetaur clllium 
axlipisicing pecu, sed do eiusmod 
tempor incldidunt ut labore et 
dolore magna allqua. Ut enim ad 
minim veniam, quis nostrud 
exercitation ullamco laboris nisi 
ut aliqulp ex ea commodo 


Collection 


> 



Family 


All Fonts 


American Typewrite 

. Regular 

14 

English 


Andale Mono 

w Light 

9 I 


Favorites 


Arial 

Bold 

10 


Recently Used 

Lorer 


Arial Black 

Condensed 

11 


. Custom 
lamet 


Arial Narrow 

Condensed Light 

12 



axiipii 

tempi 

dolor 


Fixed Width 
Fun 

Modern 


Condensed Bold 



mlnir New-1 
exerdi 
ut all 


Arial Rounded MT [ 
Arial Unicode MS 
Arno Pro 
Bank Gothic 


...you caw only change things for the entire field! 

Although the text view has served our purposes so far, introducing the requirement to 
be able to bold just one word means that we need to change our view. UITextViews 
can be formatted through a recent addition to iOS called NSAttributedString, but 
these are not for the faint of heart. If you want to start treating any of the text 
differently (color, bold, underlining, etc.), you need to amp things up a little. Rather 
than going the N S Attribute String route, we can take advantage of everyone’s favorite 
markup language, HTML, with some styling through CSS. 


Tkere^s anotker 
control lor tkis 
kind oi tiring … 
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fireside chats 


UlWcbvicw has lots of options 

Although inserting a web view might not be your first thought, it’s often one of the best ways to 
handle complex text formatting. Web views not only allow you to embed material on the web 
directly into your app without leaving and going into Safari, but you can also load from HTML/ 
CSS files that you ship (or generate) as part of your application. 

UlWebViews are basically Safari in a box — not only can they render HTML, they can also be 
used to embed lots of document types, including Microsoft Office and Apple’s iWork office suite 
(Pages, Numbers, and Keynote), PDFs, and RTF documents. 

In short, anything Safari can render, a Web View can render too, inside your application. More 
than just a developer convenience, this can also be really important for user flow. 


Fireside Ghats 



Tonight’s talk： We need more options! 


UlWebView: UITextView: 

Well UITextView, I guess you’ve outlived your 
usefulness. 

What? I’ve been performing great. 

That’s true, you’re really good at what you do, it’s 
just...well, you’re so limited. 

That’s not true. Without any code at all, you can 
cut and paste, scroll through text, select text, and 
search it. 

All true, but it really starts to fall apart when 
you need to get fancy. Developers who use me 
get HTML5 and CSS3 support, not to mention 
the ability to show PDF, Word, Excel, Keynote, 

Numbers, and PowerPoint files. 

That’s true, but I’m a whole lot simpler. And if you 
really want fancy colors and whatnot, you can get 
there if you try hard enough. 
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UlWebView: UITextView: 

But I’m much more than just fancy colors. With 
CSS, you get all the styling and layout support you 
get with normal web development — and you can 
use the same tool. Not only that, but you can use 

JavaScript for interactivity. . . . 

" ' But we’re talking about jamming a web browser 

into the application. You can just hand me a string 

and I’m good to go, you don’t need to go and load a 

website or anything. 

Actually, you can give me a string, too — it just 
has to be an HTML string. I also support loading 
local resources like embedded CSS files, images, 

JavaScript, or even full HTML files. 

Interesting. OK, can you edit the text? 

Hmm.. not really. I can show HTML forms and 
things like that, but no, I guess I really don’t fit for 
text editing or things like that. 

Gan you interact with the user or the rest of the 
application at all? 


Oh yeah. Like I said, basically anything you can 
do with a web page you can do with me in terms 
of interacting with the user. As for interacting with 
the rest of the application, that’s a little tricker. I 
have a couple of delegate methods that get called 
when I need to know if I can follow a link that the 
application can use to move information out, and 
I can evaluate any JavaScript the application sends 
me and return the results. But, admittedly, it’s not 
quite as simple as just manipulating a string. 

Here’s what I think. I think I’m more about 

straightforward text editing, you’re more about style. 

I can live with that. I’m like a browser in a box, 
you’re more of a...souped-up Text Field. 


I liked how I put it better. 
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three’s company 


HTML, CSS, awd Objective - C 

Using a UlWebView is like a cross between a website with basic HTML/CSS and Objective-G. 
All three of these things work together to create the view that the user is going to see. 
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Fugitive.css 
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Using UlWebView 


For our purposes, we’re going to need to generate an HTML version of our fugitive 
description and last known location. We can then apply some basic CSS to get it to look 
however we want. We’re going to be working with CSS to actually draw the notebook paper 
area within the view, so it won’t be an image. We’re also going to set up the pushpin image 
directly from the CSS so it will stay within the WebView and move and scale as needed for the 


view. 


To do this we’re going to need to make a couple of changes. First, we need to swap out our text 
views for UI Web Views. That’s pretty straightforward. 

Next, we need to generate the HTML. We can use NS String’s stringWithFormat to do that. 
Normally it’s a lot easier to write the HTML and CSS you want and get things set up using a 
Web Browser or any other HTML editing tool, and then move it into code. We came up with 
HTML that looks like what you see on the opposite page: 


㈣ :5 


w\OV*C— 
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rel=-stylesheet^ typftext/css" href-fugitxve . css^ 

<body> 


> 


<dl class="dossier"> 

<dt>Name: </dt><dd>%@</dcl> 

<dt>ID:</dt><dd>%@</dd> 

<dt>Bounty :</dt><dd>%@</cicl> 

<dt>Description : </dt><dd>%@</dd> 

</dl> ^ rtTMU At^°^ V ' st 

多 SC \tass TV>e — 

V^a^les tV>e vest- 




tV^c av? 


</body> 

</html> 


Finally, we’ll need to tell the new WebViews to load our dynamic HTML by 
using loadHTMLString. We want to use our local CSS file, so we need to give 
the Web View a code format baseURL that points to our application bundle. 
After that, the Web View handles the rest. Let’s get that going... 



First we’ll get the HTML and webViews working to replace the textViews. Leave 
out the CSS link code for now, we’ll get to that in a minute. 

Delete the two text views and replace them with UlWebViews. 

Turn off “User Interaction Enabled” and uncheck “opaque” in the Utilities pane for 
both UI Web View. Don’t forget to handle the IB Outlets to these views as well. You’ll 
need to change their types in the header and then reconnect them in Interface Builder. 
Finally, set their background color to clear in viewDidLoad. 


e 

o 


Refactor the code for the prepareFugitiveDescription. 


We’ll need to prepare the fugitive description with HTML and then we’ll #define a 
constant to handle the case when we don’t have a fugitive. 

Refactor the code for the prepareMapDescription. 





We’ll need to prepare the fugitive description with HTML and then we’ll #define a 
constant to handle the case when we don’t have a fugitive’s position. 



Load the HTML text in updateDossier and viewDidLoad. 

Now that we can create HTML versions of our descriptions, we need to update our 
updateDossier method and viewDidLoad to tell the WebView to load its content from an 
HTML string rather than just setting a simple string on the text view like before. 
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exercise solution 


Exe • 


fu：iSe 

luiiOH 


First, we’ll get the HTML and webViews working to replace the textViews. Leave out the CSS 
link code for now, we’ll get to that in a minute. 



Delete the two text views and replace them with UlWebViews. 

Turn off “User Interaction Enabled” and uncheck “opaque” in the Utilities pane 
for both UI WebViews. Don’t forget to handle the IBOutlets to these views as well! 
You’ll need to change their types in the header, then reconnect them in Interface 
Builder. Finally, set their background color to clear in viewDidLoad: 


[fugitiveDescription 一 setBackgroundColor : [UlColor clearColor]]; 
[mapDescription setBackgroundColor : [UlColor clearColor]]; 



u sct tWs •- ^ 
•m 从 at? 


t 
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iPad Ul 



Refactor the code for the prepareFugitiveDescription. 

We’ll need to prepare the fugitive description with HTML and then we’ll 
#define a constant to handle the case when we don’t have a fugitive. 


- (NSString *) prepareFugitiveDescription { 

NSString ^response = nil; 

if (self.fugitive) { 

response = [NSString stringWithFormat : @ "<htmlXbodyXdl 
class=\ A, dossier\^Xdt>Name :</dtXdd>%@</ddXdt>ID :</dtXdd>%@</ 
ddXdt>Bounty : </dtXdd>%@</ddXdt>Description : </dtXdd>%@</ddX/dlX/ 
bodyX/html>", 

fugitive—.name, 

[fugitive—.fugitivelD stringValue ], 

[fugitive—.bounty stringValue ], 
fugitive .desc]; 


else { 

response = 

} 

return response; 


NO FUGITIVE SELECTED HTML 


a 七 e o 吖 

data- Wc 6ould also ' 

HTML •« 山 a ⑽山孙 
七 Wis me 七 W 吖 cva 




#define NO 一 FUGITIVE—SELECTED 一 HTML @ 〃<htmlXbodyXdl 
class=V’dossier\ 〃 Xdt>No fugitive selected. </dtXddX/ddX/dlX/ 
bodyX/html>"; 




y/e dcm ’ 七 V^avc a -fugitive selected) v/c 
jus*t use HTML- 


FugitiveDossierViewController.m 
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exercise solution 



First, we’ll get the HTML and webViews working to replace the textViews. Leave out the CSS 
link code for now, we’ll get to that in a minute. 


Refactor the code for the prepareMapDescription. 

We’ll need to prepare the fugitive description with HTML and then we’ll 
#define a constant to handle the case when we don’t have a fugitive’s position. 


- (NSString *) prepareMapDescription { 

NSString ^response = nil; 

if (self.fugitive && self.fugitive.lastSeenDesc) { 

response — [NSString stringWithFormat : @ 〃<htmlXbodyXdl 
class=\^dossier\^Xdt>Last Seen :</dtXdd>%6.3f, %6.3f</ 
ddXdt>Descr iption : </dtXdd>%@</ddX/dlX/bodyX/html> /, , 

[fugitive—.lastSeenLat doubleValue ], 

[fugitive—.lastSeenLon doubleValue ], 
fugitive .lastSeenDesc]; 


else if (self.fugitive) { 

response = NO 一 KNOWN 一 LOCATION 一 HTML; 

} 

else { 

response = NO 一 FUGITIVEJSELECTED 一 HTML 

} 

return response; 


Xsi V>kc m 

? o?ulatc ^ ¥ 

d3*t3* 


#define NO 一 KNOWN 一 LOCATION 一 HTML @ "<htmlXbodyXdl 
class=V’dossier\”Xdt>No last known location. </dtXddX/ddX/dl 
bodyX/html>"; 



TV^is Co^siav\i is -for wc Viavc d 

but dU’Uavc a last k 卿 Ua 七’隊 



FugitiveDossierViewController.m 
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Load the HTML text in updateDossier and viewDidLoad. 

Now that we can create HTML versions of our descriptions, we need to update 
our updateDossier method and viewDidLoad to tell the WebView to load its 
content from an HTML string rather than just setting a simple string on the text 
view like before. 


w m ou, HTML- 



NSString *path = [[NSBundle mainBundle] bundlePath] 

NSURL *baseURL = [NSURL fileURLWithPath:path]; 

[fugitiveDescription 一 loadHTMLString : [self 
prepareFugitiveDescription] baseURLibaseURL]; 

[mapDescription 一 loadHTMLString : [self prepareMapDescription] 
baseURL:baseURL]; 




!rw ； r^ 办 


FugitiveDossierViewController.m 
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test drive 



TesT DriVq 


The refactoring should be complete. The formatting isn’t done yet (that will happen with the CSS), but 
for now, the webViews should be in place and functioning... 
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Use CSS for the remaining 
formatting 

Now we’re ready to get into the CSS. We have a 
bunch of things we need to accomplish with the 
formatting, and all of it’s going to happen inside this 
CSS file: 


l*mc 


-A C :广 
二; 二一:二 
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I^rtnatting Text Up C^se 


Wcrts ouv s*tylcsiicc*t 七 ha 七 WII use *fov 
-Pov-rwa-ttmj *thc m ouv y/cbv*icw. 


dl.dossier 

{ 

min-width : 300px; 
min-height : 150px; 

-webkit-box-shadow : rgba(0 , 0, 0, 0.5) 0 0.3em 0.3em 0; 

background-image : -webkit-gradient(linear f 0% 0%, 0% 100% 
stop( 95% A #FAFAFA ), color-stop( 95% , #FAFAFA ), color-stop (100% 


color- 
#DDF)) 


background-size : 1.6em 1.6em; 
margin : 0; 
padding : .5em; 

f ont-f amily: ''AmericanTypewriter' 



dossier dt 




a'dosiv 6lass. 

fjuooMook^ b 却一 


padding-right : .2 em; 

display : run-in; 
font-weight : bold; 


dossier dd 




margin-top : .5em; 

margin-left : .5em; 

margin-right : .5em; 

padding-right : .5 em; 



.dossier : after 

{ 

display : block; 
content : ； 

position : absolute; 
width : 50px; 
height : 35px; 


4 




⑽:工 :六二 r ld 

v»ave la«d ar.o-kV»ev U ^ a< j ^ 

愉 , Wt 細 w 娜 W Y 


background : transparent url(pushpin.png); 
top : - .05em; 
left : 50%; 


•CSS 


Fugitive.css 
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test drive 




Tesr DriVq 


This is it! Go to www.headfirstlabs.com/books/hfiphonedev and get the fugitive.css file and add 
it to the / SupportingFiles directory. Then add the following HTML right after the <html> 
tag in the four locations in FugitiveDossierViewG ontroller where you generate the map 
and fugitive descriptions: 


Clink rel=\"stylesheet\^ type=\^text/css\^ href=\"fugitive.css V’ /> 



Dossier 


Nunc: £jjti Komcro 
I»=545S3 


Fugitives 
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eeorgt Palin 
htenry Lewis 
Hunler Sweeney 
L Slo! efl 


Jackson Jonr&s 


Jenniiter Mm 


If# Ih^I known 


Smiley 
Joe Oenlela 


John Ifahia 


Jylie Goriman 


Kate Barnes 


596 Chapter 11 











































iPad Ul 



Justice is served! 

Bob is really happy, and this is a great 
universal app. Two completely different 
use cases have been handled: catching 
the fugitive and reporting it, as well as 
researching the fugitive in detail. 

There’s only one database to maintain, 
but two totally different views, and 
the code is shared, so making updates 
should be a breeze. 

Congrats! 
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NUI Cross 


This is it! Exercise your vocab skills and make sure 
you learned some new lingo... 



Across 

1 ■ WebViews can be laid out with_. 

5. _in Ul helps users figure out how to work with 

the app. 

6. iPhones and iPads have_use cases. 

8. This type of view displays text with lots of formatting options. 

9. Views are constructed with_. 


Down 

2. This displays text, but has limited formatting options. 

3. This kind of interface is preferable for iPad. 

4. Webviews are formatted with_. 

7. The unifying design for an app is sometimes called a 


10. Text in TextViews must be formatted the 
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iPad Ul 


Your NU1 Toolbox 

You’ve got Chapter 11 under 
your belt and now you’ve added 
iPad user interface skills to your 
toolbox. 





u mLdvip 
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NOI Cross Solution 

This is it! Exercise your vocab skills and make sure 
you learned some new lingo... 



Across 

1 ■ WebViews can be laid out with_■ [HTML] 

5. _in Ul helps users figure out how to work with 

the app. [REALISM] 

6. iPhones and iPads have_use cases. 

[DIFFERENT] 

8. This type of view displays text with lots of formatting options. 
[WEBVIEW] 

9. Views are constructed with_. [LAYERS] 


Down 

2. This displays text, but has limited formatting options. 
[TEXTVIEW] 

3. This kind of interface is preferable for iPad. [NATURAL] 

4. Webviews are formatted with_. [CSS] 

7. The unifying design for an app is sometimes called a 
_■ [THEME] 

10. Text in TextViews must be formatted the_. [SAME] 
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/ leftovers 

參 


The top 4 things 

(we didn’t cover) ♦ 



Ever feel like something’s missing? We know what you mean... 

Just when you thought you were done, there’s more. We couldn’t leave you without a few 
extra details, things we just couldn’t fit into the rest of the book. At least, not if you want to 
be able to carry this book around without a metallic case with castor wheels on the bottom. 
So take a peek and see what you (still) might be missing out on. 
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internationalization and localization 


Nib files (views, labels, button text, etc.) 

Location or culture-specific icons and images such as flags or text 
Included or online help and documentation 
Static text in your application 



Once you’ve identified the culture or language-specific parts of your application, 
the next step is to localize them. iOS has strong support for localizing resources 
and separates the localizable resources from the rest of the application so you can 
easily use a localization team or outsource the effort all together. 

Up until now, our resources have been included in our application in the .app 
directory. Once you start localizing resources, Xcode creates an lproj directory for 
each localization (locale) you add and moves the locale-specific resources there. 
For example, if you provide both English and French translations of your nibs, 
then you will have an en.lproj (or English.lproj) and fr.lproj directories in your 
application. 

Localizing nibs 

Xcode has built-in support for localizing 
nibs. Before you start translating anything, 
you need to ask Xcode to create the locale- 
specific directories. 

Sclcd*t 3 





Vou 63 ^ 冼 a 呼 7 减 la 呼 ay 
a,d locale o, .PW V>7 ^ 
•，山 Sett.my 一爲⑽ al 

七 ，。灼 al . 


H rv 


(>) Cm) |Prtaa»Hf L 



Localization is 


# 1. Internationalization and Localization 

iOS devices are sold in over 80 countries and support 30 languages out of the box. 
Depending on your application, you should consider supporting multiple languages 
and cultures. Internationalization is the process of identifying the parts of your 
application that are culture or language-specific and building your app in a way that 
supports multiple locales. Some of the things you should look at are: 


o o o • 
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leftovers 


Next, click on the + button under the Locialization group. Xcode will turn your nib entry in the project list into a group 
with each localization listed beneath it. Xcode copies your original nib into your default localization. 




DrinkMixrr - DrinkDplAi IVipwCQfilrallf!r.sci：b 



Cli ^ Oh ihc w - 
-to 

havc dw t t{ 


The next time you click the + button, a drop-down box will 
appear and you can select any language you want to use. 
There will be a new nib created for each language. 


丄 select every 
^ouh-t^y you 娜七 
he\rc. 



English 

Italian 

Norwegian Bokmal 


English 

Italian 

Norwegian Bokmal 
Add all 

Japanese (ja) 

French ffr) 

German (de) 

Spanish (es) 

Portuguese (pt) 

Portuguese—Portugal (pt-PT) 
Dutch (nl} 

Swedish (sv) 

Danish (da) 

1 Finnish (fij 
Russian (ru) 

Polish (pi) 

Chinese (zh-IHans) 

Chinese (zh-Hant) 

Korean (ko} 

Other 
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localizing sfr/ngs 


Now all you need to do to localize the nib is double-click the 
language you want to localize and translate any text. Remember 
that depending on the language, you may need to adjust layout 
as well. 

For large projects, there is a command-line tool called ibtool 
that you can use to extract all string values from a nib into an 
external file, then merge translations back into the nib later. 

This allows for bulk extraction and translation, but you need 
to be particularly careful about layout issues since you’re not 
visually inspecting each nib. Once a nib has been translated, 
you can have Interface Builder mark it as locked to prevent any 
accidental changes to the text or layout that could impact your 
translations. See Apple’s documentation on bundles and nib 
localization for more information. 

Localizing string resources 

In addition to nib text, text in your application that you intend 
on showing the user needs to be localized as well. For example, 
the Action Sheet used in iBountyHunter offers the user the 
option to take a photo, choose an existing one, or cancel. That 
button text is generated programmatically and needs to be 
translated appropriately. 


_ 


DrinkMixer 

1 target, i05 SDK 4.3 

LJ Classes 

b Root Vie wCo mtroi I er.h 
m Root Vie wCo ntroi I er„m 
h Dri nk MiixefA ppDe le gate, b 
m Dri nk M ixerA ppDe le gate, m 
h Drf nkDetai i Vi ewControl !e r, h 
m DrC nkDetai I Vi ewCon Erol le r. m 
h DrinkConstant&.h 
二 Other Sources 

h Dri nkMixer_P refi x.pch 
m 1 rnain.m 
Resources 

I Dri nkDi rectio ns, pi i st 
-■Dri mkDetailVi ewControl le r.xib 

- Dri nk Detai IVi ew€on tro[ le r.x i b (English) 



DrinkDelai iViewControde r.xi b CltaFiao 




Dri rikDetailVi ewCon … (Nomegian Bok mal) 
A Root Vie wCo ntroi I er.xi b 
A MaEfiWindow.xib 
I Dri rikMiixer- In fo. plli &t 
j DrinkArray.piist: 

Frameworks 
I ' I Products 


For this type of text, called string resources, the iOS uses strings files. You’ll 
generally have one of these files for each language you support. Each file contains a 
description of what the string is trying to communicate, the default language version 
of the string, and the translated version, like this: 




'^ Confirms a really bad decision. * 
、 A11 In 〃 = ''All In 〃； 


纖 一 


Cancels the dialog * 
'Cancel^ = ''Cancel^; 


’* Title for the important alert view */ 
'This is important 丨〃 =''This is important! 


/* Warns the user about impending badness. */ 
''This will empty your bank account. Are you sure? 
your bank account. Are you sure ?〃； 


tacM V^as 叫 mal 


'This will empty 
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Generating your strings file 

You could create your strings file by hand, but a much simpler way is to have Xcode generate it for 
you. Xcode does this by looking for the localization macros that load the translated text. To support 
localized strings, you should use one of the NSLocalizedString macros, like this: 


usuallv default la 呼 ay “r 如 


The 


-( 工 BAction) pushMePressed: (id) sender { ) is 

UIAlertView *alertView = [ [UIAlertView alloc] \^. 〆 S"tv-iha ^ S ^ OWh wi-th 

initWithTitle : NSLocalizedString (@〃This is important !’’， ° ，h c s br\y\^s . 

@〃Title for the important alert view ”）^ 」 

message : NSLocalizedString(Q^This will empty your bank account. Are you sure ?’’， 

Warns the user about impending badness .’’） 

delegate : nil 

cancelButtonTitle:NSLocalizedString(@ 〃 Cancel 〃， @〃Cancels the dialog ”） 
otherButtonTitles : NSLocalizedString(@ 〃 A11 In ”， 

@^Confirms a really bad decision .’’）， 

nil]; 

[alertView show]; 


If you’ve used the NSLocalizedString macros in your code, you can generate your strings file 
simply by running the genstrings command at the command line, like this: 

genstrings -o English.lproj 


You’ll want to run this for each translation you support. This will create a file named 
Localized.strings in the specified locale directory that you can give out to translators. You’ll 
need to add that strings file to your Xcode project like any other resource, but once it’s there, 
the iOS will look in the appropriate strings file at runtime based on the language the users 


select for their device. 

The iOS provides robust localization capabilities, including 
currency, time, and date presentation support; we’ve just 
scratched the surface. Apple provides several documents 
on internationalization and localization, including the 

“Introduction to Internationalization Programming 
Topics” document in the Xcode documentation, to help you 
with more complex scenarios. 



iOS caches resources! 

If you’ve installed your app 
\ t 4- \L before doing translations, 
W^LCh It ： jfs likely that the iOS has 

cached resources so that 
even after adding translations, you won’t 
see them until you uninstall and reinstall 
yourapp! 
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animation is fun 

# 2. View animations 

If you’ve spent any time with an iOS device, you know that smooth transitions and graceful 
animations define the user experience. In the applications we’ve built so far, we’ve only touched on 
a few basic animations (like the flip animation used in iBountyHunter). However, everything from 
adding and removing table rows to sliding controls around the screen can be animated. 

Animating table view updates 

If you’re going to add or remove multiple rows in a table view, you can ask it to provide a smooth 
animation (as well as a more efficient handling of updating the table view itself) by sending it the 
beginUpdates message before you start manipulating the data, then an endUpdates when you’re 
finished, like this: 


[self . tableView beginUpdates] ; 

[self.tableView insertRowsAtlndexPaths:insertlndexPaths 
withRowAnimation : UITableViewRowAnimationRight]; 

[self.tableView deleteRowsAtlndexPaths:deletelndexPaths 
withRowAnimation : UITableViewRowAnimationFade]; 

[self.tableView endUpdates]; 


Uc bc 3 *mU ? aatcs a,d educates tell 
about t so \i anally 

W • 叫』 3 士如 ^dUfdatcs tall; 


Jerboa deletion) y/*»ll be animated a*t 

Animating view and control changes 


^V OU ^ 

With ^ 

，命七 b add. Tk UL 'I 
ask datasou^c a^d 
tell ^rov 

七 Wc … 一 〆/ 

七 he akiwaticm m+ov-watioy\, tn«7 

swoo^Iy slide m*to i\\t taWc. 


Similar to table views, UlViews have built-in support for smoothly animating changes to several of 
their properties. You simply need to tell the view that you want it to animate a change by sending it the 
begin Animations message, describing the end point of the change, and then asking it to start the transition by 
sending it the commitAnimations message. The following UIYiew properties can be animated automatically: 


W|\/icw pvopev-ty 

Description 


The physical 七 des^v-ibes 七 he view—viev/^s o\ri^*m 

Bv\d siz^—*m *thc supev-viev/^s 匕 oovdmatc system 

bounds 

The ovi^rn siz^ view m lo^dl 匕 oo\rdmd*tcs 


The o( *thc view m *thc supev-view^s ^oovd'ma-tcs 

■tva^s-fovrw 

A^y *tv-a^s-fov-ma*tio^s (v-otatio^s, *tva^sla*tio^s, ctd ) applied h> *thc 
view 

dlfhd 

The *tv"3^spa\rc^dy o-f View 
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Accelerometer 


One of the most versatile pieces of hardware in iOS devices is the accelerometer. The 
accelerometer allows the device to detect acceleration and the pull of gravity along three axes. 
With just a few lines of code，you can tell whether the device is right-side up, upside down, 
laying flat on a table, etc. You can even detect how quickly the device is changing direction. 

All you need is the UlAccelerometer 


Getting orientation information from your device is straightforward. There’s a shared 
UlAccelerometer instance you can access. Like many other iOS classes, the UAccelerometer 
has a delegate protocol, UIAccelerometerDelegate, that declares a single method for receiving 
acceleration information. The class you want to receive that acceleration information should 
conform to the UIAccelerometerDelegate protocol and implement didAccelerate: method. 


一 （ void)accelerometer:(UlAccelerometer accelerometer 
didAccelerate : (UIAcceleration *)acceleration; 






To receive acceleration information, you simply need to tell the accelerometer about the t 、 1 工 4 心 : S 
delegate and how frequently to send acceleration information, like this: 






self.accelerometer = [UlAccelerometer sharedAccelerometer] 
self.accelerometer.delegate = self; 
self•accelerometer•updatelnterval = 0.5 f; 


6iti slaved 


d 扒 


… delegate dirw 
update v*a*tc m sttoY\ds> WlcVc *fov 
*t>wo updates a second- 


Each UIAcceleration object contains acceleration information along the x, y, and z axes and a 
timestamp indicating when the data was collected. In a simple example, you can update labels with 
the acceleration information, like this: 


- (void)accelerometer:(UlAccelerometer *)accelerometer 
didAccelerate:(UIAcceleration *)acceleration { 

self.xOutput.text = [NSString stringWithFormat :@〃％ 
self.yOutput.text = [NSString stringWithFormat :@〃％ 
self.zOutput.text = [NSString stringWithFormat :@〃％ 


acceleration.x]; 
acceleration.y]; 
acceleration.z]; 
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acceleration is fun 


Understanding device acceleration 

First, the bad news. The simulator doesn’t simulate the accelerometer at all. 
You’ll get no information back, regardless of how much you shake your Mac. 
You need to install the application on a real device to get actual accelerometer 
information back. But once you do... 


7 0 axis.. 
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+x 
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If you’re building a typical view-based application, UIKit hides a lot of the 
need for the accelerometer by letting you know about orientation changes 
and automatically providing undo/redo when the user shakes the phone. The 
accelerometer is most useful for custom-drawn applications like games (steering or 
balance) and utility applications (for example, levels). 
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『 Sent Events 
Did End On Esit 
Editing Changed 
Editing Did Begin 
Editing Did End 
To-uch Cancel 
To-uch Down 
To-uch Down Repeat 
T"auch Drag Enter 
Touch Drag Ex il 
Touch Drag Inside 
Touch Drag Outside 
Touch Up Inside 
Touch Up Outside 
Valu*e Changed 
Referencing Outlets 

New R-eferenciifug Outlet 

Referencing Outlet CollectH 
New Referencing Outlet Collectim 


# 4. A word or two about gammg. 


iOS games are a huge market and get played a lot, but they’re also pretty advanced applications. 
It’s outside of the scope of our book to get into those applications — which can use multi-touch 
interactions, Quartz and OpenGL graphics, and peer-to-peer networking — but here, we’ll give you 
a quick pass at the technologies that you can use and where to find more information about them. 


Multi-touch 

You probably noticed that we only used one of the possible events 
that can be triggered for a button in our apps, the touch up inside 
event. iOS is capable of detecting up to five finger touches at a time 
and can interpret how each of those fingers is interacting with the 
screen with several different types of events. 

In addition to touches, iOS can detect swipes and gestures that 
can be configured as well. By defining the length and direction of 
a swipe, you can create lots of different ways to interact with your 
application. 

Pinching is a custom gesture that Apple uses in many of its default 
applications, most notably Safari, to zoom in and out of a view. It 
is just registering for a two-finger touch and keeping track of the 
change in the distance between them: If it increases, zoom out, if it 
decreases, zoom in. 

Using these events means you can create custom interfaces — not 
just touching buttons — for your user. Working with multi-touch 
means that your view needs to be configured to be a multi-touch 
view, and then you need code to work with each different type of 
event you’re interested in leveraging. 

Working with these events requires working with the responder chain (see the UIResponder class 
reference) and the UIEvents class reference. 


These av-c all 

Can be 
-tv-ijjcv-cd- 


o^^xsoooooooo o o 
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drawing pictures 


Quartz and Open&L 


Quartz and OpenGL are the two ways to create graphics on iOS, and they’re both big enough 
to be books on their own. Here’s a small sample of what you’d be dealing with: 




Quartz is the simpler of the two, allowing you to draw in two dimensions directly into the view. 
The drawing code uses the Core Graphics Framework and renders directly into the view. It 
follows a painter’s model, which means that the order of commands is important. The first 
thing drawn will be covered up with a subsequent drawing in the same location. Quartz can 
handle shading, color, and interfacing with other image and video types. 

The Quartz 2D Programming Guide in the developer documentation has a lot of 
information to help get you started. 


Open&L 


OpenGL can work in two or three-dimensional graphics and is significantly more complex, 
but that means that you have more flexibility to work with. It is a well-established, cross¬ 
platform library that has been implemented for mobile devices with OpenGL ES, and it’s used 
through the OpenGL ES Framework. 

You can use it to draw lines, polygons, and objects, and animate them as well. A good place 
to get started is with the OpenGL ES Programming Guide for iOS in the developer 
documentation. 


^amc Kit 


New with the iOS 3, the Game Kit framework allows you to use both peer-to-peer networking 
and voiceover bluetooth to facilitate interaction with other devices within game play. This 
functionality does not exist for the first generation iPhone, iPod Touch, or the simulator alone. 

Similar to the image picker, there is a GKPeerPickerGontroller that provides a standard 
interface for finding other devices running your application and establishing a connection. 
After that connection is established, you can transmit data or voice between devices. 

A good place to get started is with the Game Kit Programming Guide to leverage this 
new functionality in your app. 
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ii preparing an app ?9r distribution 


參 

Get ready for the App Store 





You want to get your app in the App Store, right? 

So far, we’ve basically worked with apps in the simulator, which is fine. But to get things 
to the next level, you’ll need to install an app on an actual iPhone, iPad, or iPod Touch 
before applying to get it in the App Store. And the only way to do that is to register with 
Apple as a developer. Even then, it’s not just a matter of clicking a button in Xcode to get 
an app you wrote on your personal device. To do that, it’s time to talk with Apple. 
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get your development certificate 


Apple has rules 


: vel 7_ “ 


We’ve talked about the HIG and how stringent Apple can be throughout the 
approval process — they’re protecting their platform. Part of that requires 
keeping track of what goes on your own device, even when it’s stuff you’ve 
written yourself. 

Here, we’re going to give you an overview of how you can get an app onto 
your device, and then, in turn, ready for submission. We can’t get into the 
nitty gritty of the full process — for that, you need to be a member of the 
iOS Development Program and pay the S99 fee. 

Start at the Apple developer Portal 

The Developer Portal, where you first downloaded the SDK, is also your hub for managing all the 
parts of electronic signatures that you’ll need to get an app up and running on your iOS device. 

First get your development Certificate 

Getting through the process to go from having your app in Xcode to installing it on an iPhone, 
iPad, or iPod Touch for testing requires a Development Certificate and a Provisioning Profile. 

This certificate is signed by you and Apple to register you as a developer. It creates a public and a 
private key, and the private key is stored on the keychain app on your Mac. Here’s how getting that 
certificate works. 


Revest (CSR)- 


个 

Submi 七七 he CSR *to Apple -fov- approval- 


Apple approves the 
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preparing an app for distribution 


The Provisioning Profile pulls it all together 

Now that you have a Development Certificate in place, to complete the process, you 
need a Provisioning Profile. That electronic document ties the app (through a UDID), 
the developer, and the certificate together for installation onto the device. 
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Watch it! 


You can’t get a 
Provisioning 
Profile without 
a Development 
Certificate. 
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stay organized 


Keep track iw the Organizer 


The Organizer is a tool that comes with Xcode that we haven’t been able to 
talk much about, but it’s key for keeping all this electronic paperwork straight. 
In Xcode, go to the Window - ^Organizer menu option. 
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A few final tips, 


This quick overview gives you an idea of how the process works, but you need /vIq^^ I C 
to get into the Developer Program to learn all the details. Our goal here was ' 

just to help you see the big picture of the process. 


There are a couple of things to be aware of. First, when you’re developing 
as part of a team, the team admin has to be involved in many of these 
steps. Second, you need to go through this process to install anything on your 
device, regardless of whether you plan to release it to the world or not. 

And finally, what about the app store? Once you’ve joined the Developer 
Program and the application has been tested, then you can submit it for 
approval. 
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“@” before strings 69 
@dynamic directive 409 
@end 105 
&error 475 
# import 104 
@interface 103, 104 
@private sections 104 

@property 27 ， 105, 106 
with @synthesize 85, 116 
@public sections 104 
@“sleeping” 124 
@ symbol 32, 159 

@synthesize 85, 106, 108 
with @property 85, 116 

A 

accelerometer, getting orientation information 607 
accessors, auto-generated 109 

actions 77-82 

events (see events) 

(see also IBAction) 

action sheets 522-527 

implementing delegate methods 523 
AddDrinkViewGontroller 231—240, 243—245 
adding ability to edit 307 
dismissModalViewGontrollerAnimated 245 
saving new drinks 279—281 

aesthetics 47 

alloc 111 

init call after 120 

Allow Selection While Editing 306 
Anatomy of a Crash 199 
animating view and control changes 606 
animation and curve properties in notification 276 


annotations 553-555 
APIs, undocumented 32 
AppDelegate 298, 334 
AppDelegate_iPhone 376, 377 
AppDelegate_Shared 377, 423 

App Layout Construction 45—47, 221, 241 
solution 222 

Apple guides and tutorials 48 
Apple iOS SDK (see iOS SDK) 

Apple’s Developer Program 527 
registering with 526 
applicationWillTerminate 475 

App Magnets 43 
Solution 44 

app patterns (see design patterns) 
apps 

aesthetics 47 

building app for iPad vs. iPhone 323 
configuration information 47 
controls 44 
crashing 294 

delegate providing the content 63 
design patterns (see design patterns) 

DrinkMixer (see DrinkMixer app) 
email messaging framework 44 
events 76 

failing to implement a required method in a protocol 
74 

File’s Owner 56 
good design vs. bad design 56 
GUI builder (see Interface Builder) 
icons 56 

immersive (see immersive apps) 

Interface Builder (see Interface Builder) 
interface vs. protocol 74 

iPhone application structure and where you can read/ 
write 422 

iTunes App Store 20 
layout 44 
lifecycle of 4, 472 
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limits to the number of protocols a class can realize 
74 

multiple views (see multiple views) 
nib 56 

picker methods 76 
productivity (see productivity apps) 
rebuilding for other phones 20 
resources 33—34 
starting with a sketch 44 
switching 294 
templates 8-9 
types 48 

universal 359, 364 

Universal App Distribution xvi—xvii, 324—325 
usability 47 

usability and aesthetics 47 
utility (see utility apps) 

Xcode and templates 8 
(see also iTunes App Store) 

AppStore 3, 197, 211, 212, 216-218, 317, 323 
basics 249 

submitting app to 611 
universal apps 364 

arguments, named 127 

arrays 298 

dictionaries 202 

getting data into detail view 206—210 
hardcoded into implementation file 161 
plists 165 
saving 295-296 
sorting 292 

assign 108, 139 

and NS String 110 
Assistant Editor 11,13,27 
asterisks 104 
atomic 108 

Attributes Inspector 123 
auto-generated accessors 109 
automatic migration 460 

automatic NSManagedObject file generation 553 
autorelease 111 


B 

background time 473 

batteries and Core Location 537 

BOOL, using to track keyboard 269 

BountyHunterHD 570 

brackets for message passing 130 

breakpoints 190 

Bullet Points 

automatic migration 460 
Cocoa Touch 31 
Core Data 444 

filtering data based on logical conditions 496 

hierarchy view for the xib files 390 

IBActions 31 

IBOutlets 31 

Interface Builder 31 

iOS tables 171 

iPhone Simulator 31 

lightweight automatic migration 460 

lightweight migration and adding variables 460 

Managed Object Context 444 

Managed Object Model 444 

multiple views 171 

Navigation controllers 171 

nib files 31 

NSFetchedResultsGontroller 496 
NSFetchRequest 496 
NSPredicate conditions 496 
Objective-G 

method arguments 130 
method declarations 130 
method implementations 130 
send messages to receivers 130 
picker 74, 96 
productivity apps 171 
protocols 74 
table views 171 
viewWillAppear 496 
*.xib files 171 
Xcode 31 

buttons 

adding to view 15 
changing text 19 
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HIG guidelines 51 

hooking to buttonPressed method 26 

c 

camera 

augmented reality 527 
capturing HD video 521 
checking specific capabilities 521 
devices without 527 
testing in simulator 527 
UllmagePickerController (see 
UIImagePickerG ontroller) 
video capture 521 
(see also images) 

cancel button 291 

Captured List view, building 386 

GapturedListViewG ontroller 480—483 
final code for 490—491 
refreshing data 493 

GapturedPhotoViewGontroller 505—516 
building 506-508 
displaying capture location 546 
Ready Bake Code 512 

cellForRowAtlndexPath 232 
cell identifier 154 

class, limits to the number of protocols a class 
can realize 74 

GLLocationManager 534—543 
GLLocationManagerDelegate protocol 536 

Cocoa collection types 
NS Array 165 
NSDictionary 165 

Cocoa Touch 12, 14, 20, 31, 32, 54 
datasource 62 
delegates 62 
InstaEmail 55 

common warning culprits 187 
compiler 108 

components 

triggering events 28 
configuration information 47 
constants declared with a “k” in front of them 400 


contentSize 257-258 
Gontrol-Datasource-Delegate pattern 63 

controls 44 

datasources 63 
delegates 63 

making keyboard go away 122—131 
copy 108, 111, 139 
Gore Data 

connecting to Fugitive database 417-424 

controller classes 486 

crash 452 

data types 397 

data validation 475 

date type 449 

deleting empty databases 424 
Documents directory 422 
efficient results handling 486 
filtering results 477—485 
hash modifier 460 
lightweight data migration 457 
renaming 460 
loading and saving data 396 

Managed Object Model (see Managed Object Model) 

migration outside of 460 

mismatch between database and model 452 

monitoring for changes 486—487 

NS Error 475 

overview 396 

persistence, types of 400 

requiring two models 454 

SQL datatypes/table structures 400 

stack 418 

storing user data 422 
support 361 

template and databases 421 
unsupported type 400 

GoreData cross 438 
Solution 441 
Gore Data Up Close 403 
GoreGraphics 11 

Gore Location 534—543 
batteries 537 

disabling captured switch 540-541 
framework 536—543, 547 
location accuracy 542 
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Core Location (continued) 

Map Kit, difference between 547 

speeding up initial position 542 

starting and stopping 542 

viewWillAppear and viewWillDisappear 542 

waiting rather than calling back to delegate 542 

crashes 

Anatomy of a Crash 199 
Gore Data 452 
debugging 200 
unknown selector 199 

creating a consistent look and feel 580-583 

Creating an App for iPhone and iPad 
323 

crosswords 

AddingFunctionality cross 559 
GoreData cross 441 
DataMigration cross 497 
iPad cross 357 
iPhone cross 37, 92 
iPhoneDev cross 248 
MultipleViews cross 194 
NavigationGontroller cross 312 
NUI cross 598 
Objective-G cross 138 

CSS 

Formatting Text Up Close 595 
UlWebView 588-596 

D 

data 

Core (see Gore Data) 

detail view in DrinkMixer app 168 

editing and deleting data in table view 300—307 

filtering 477—485, 499 

based on logical conditions 496 
getting data from picker using IBOutlet 83-91 
iPads vs. iPhones 564 
loading and saving 396 
managing (see managing data) 
monitoring for changes 486—487 
pickers 60 

controlled input 61 
refreshing 493 
refreshing table data 291 


saving new or changed items 499 

storing user data 422 

tab bar controller (see tab bar controller) 

viewing fetched data 412—417 

ways to save and load 171 

databases 

copying to Documents directory 423 
iPhone application structure and where you can read/ 
write 422 

saving and loading to using SQLite 171 
data migration 499 
at runtime 460 
automatic 457 
common problem 453 
data model versions 455 
lightweight 457 
requiring two models 454 

DataMigration cross 497 
Solution 498 
data model 449 
versions 455, 460 
Data model Demolition 454 

datasource 96, 159, 171 
Cocoa Touch 62 
connecting 71 
pickers 62, 65-66 
section headers and footers 159 
table views 152 
templates 152 

datasource protocols 67-74 

adding implementation code 68-69 

declaring controller conforms to both protocols 68 

required methods 70 

datasources 
controls 63 
data types 

binary 510 
Gore Data 397 
Fugitive data type 399 

dealloc method 85 
debuggers 9 

debugging 187-193, 249 

common warning culprits 187 
console 188 
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Xcode 189 

breakpoints 190 
state of application 191 

delegate providing the content 63 

delegates 24, 96, 159 
Cocoa Touch 62 
controls 63 

implementing delegate methods in action sheets 523 
pickers 65-66 
table views 152 
templates 152 

Delegation pattern 24 

Design Magnets 101 

Solution 102, 106, 116-117 
design patterns 41-98 

Gontrol-Datasource-Delegate 63 
Delegation 24 

Model-View-Controller 23, 24 
View-ViewGontroller 24 

DetailedViewGontroller 231 

detail indicators in table view 578 

detail view 

connecting to outlets 175 
getting data into 206-210 
iBountyHunter 427—436, 463—468 
files that you need 428 
populating view 434—435 
“new” drink view 228—232 
switching between list and detail views 177—182 
view controllers 
instantiating 181 

Developer Portal 612 

Development Certificate 612 

device checking 359 
universal apps 364 
devices 

checking specific capabilities 521 
without cameras 527 

dictionaries 249 
array of 202 

getting data into detail view 206—210 
key-value pairs 184 
organizing constants 207—209 
plists 203-204 
problem with 397 


dictionary key names 210 
didSelectRowAtlndexPath 303, 305, 311 
dire ctionsText View 170 ， 174, 175 
directory permissions 425 
dismissModalViewGontrollerAnimated 245, 281 
documentation, HIG (see HIG) 

Documents directory 422 
copying database to 423 
Done button and message passing 128 

DrinkDetailViewGontroller 343—348, 351—354 
refresh View 345 
UlScrollView 258 

DrinkMixer app 141—196, 198—250, 251—314 
AddDrinkViewGontroller 231—240 
saving new drinks 279-281 
Anatomy of a Crash 199 
App Layout Construction 221， 241 
Solution 222 

array hardcoded into implementation file 161 
customizing table 152 
debugging 187-193 

common warning culprits 187 
console 188 

using debugger to investigate crash 200 
Xcode 189-191 
DetailedViewGontroller 231 
detail views 168—176 

connecting to outlets 175 
dictionaries 

organizing constants 207-209 
plist of 203—204 

dire ctionsText View 170, 174, 175 
displaying drinks 154-158 
drilling into data 168 

editing tables through buttons on controller 223—227 

getting data into detail view 206—210 

ingredientsTextView 170, 174, 175 

keyboard (see keyboard) 

migrating to iPad (see iPad, migrating to) 

modal view 236—239 

navigation bar 242—246 
name key 207 

nameTextField 170, 174, 175 
navigation bar 242-246 

creating save and cancel buttons 244 
writing save and cancel buttons 245 
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DrinkMixer app (continued) 
navigation controller 151 

maintaining stack of view controllers 180 
switching between views 179 
navigation template 146—148 
“new” drink view 228—232 
NSDictionary 165, 184, 185 
on the iPad 316 
plists 162-166 
arrays 165 
built-in types 163 
creating empty 163—164 
formatting and populating 163-164 
populating table cells 154-158 
refactoring code 220 
reusing nib 230 
RootViewGontroller 156—157 
debugging 285-286 
saving array 295—296 
saving new drinks 279-281 
running on iPad without changes 317 
switching between list and detail views 177—182 
Table Cell Code Up 153 
table view 

reloading 288 
table views 146—148 
Table View Up Close 151 
UITableViewG ontroller 156 
UITextField 
disabling 176 
UITextViews 
disabling 176 
user feedback 218-220 
user interaction 145 
view controllers 

defining behavior for view 229 
instantiating 181 
maintaining stack of 180 
subclassing and extending 231 
without nib 233 

DrinksDirections.plist 185 

DRY principle (Don’t Repeat Yourself) 542 


E 

Easy GUI REGonstruction 256 

Editing view construction 301 
solution 302 
Editor Pane 10 
Editor Style 399 
efficient results handling 486 
email 

building with strings 134 

custom input 101—102 

InstaEmail (see InstaEmail) 

messaging framework 44 

UITextField and send email button 133—137 

writing app that can send 52 

events 76 

connecting to action 81-82 
connecting to methods 29 
connecting UITextField to 129 
first responder 122, 124-140, 128 
registering for 263 
triggering 28 
unregistering 263 

exceptions 199—202 
NSCF Dictionary 201 
extracting string values from nib 604 

F 

fetched data, viewing 412—417 

fields 104 

private fields 234 
uneditable 239 

File’s Owner 14,32,56,73, 230 
InstaEmailViewG ontroller 71 
filtering data 477-485, 499 
predicates 478 
Fireside Ghats 

IBActions speak louder than... a lot of things 78-79 
UlWebView options 586-587 

Universal App Distribution or not? xvi—xvii, 324—325 
first responder to events 122—125，128 
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Five-Minute Mystery 

Case of the Missing Reservations 282 
Solved 287 

flipping images 504 
Formatting Text Up Close 595 
Foundation 11 


registering with Apple’s Developer Program 526 
targets 327 
UIs 432 

UITextField 129 
getter method 105-106, 119, 139 
creating new 488 
good design vs. bad design 56 

Google Maps 

MKMapView 545 
GPS 534 


framework 20, 536—543 

Cocoa Touch (see Cocoa Touch) 

Geek Bits 11 
MessageUI 52 
nibs loaded by 26 

free 120 

Fugitive class 405-406 
NSManagedObj ect 407 
referencing rather than adding code to 554 

Fugitive database, connecting Gore Data to 417-424 

F ugitiveDe tail Vie wC ontroller 428—436 

adding properties and initialization code 465-467 

latitude and longitude 532-533 

updates 506, 507, 513, 516, 532, 536-541 

FugitiveDossierViewGontroller 571, 574-575, 581-584, 
588, 591-593, 596 

Fugitive entity 

adding properties 399 

buiding in Managed Object Model 399 

Fugitive List view 
building 382-383 

FugitiveListViewG ontroller 481 

Fugitive view controller 

creating new class for 379-381 

FugtiveDetailViewG ontroller 57 3-575 

G 

Game Kit framework 610 

garbage collector 109 


graphics on iOS 
Game Kit 610 
OpenGL 610 
Quartz 610 

GUI builder 56 
guides 48 

GUI editor (see Interface Builder) 

H 

Handling Messages Up Close 126 

hardware issues, iPad vs. iPhone 323 

•h (header) file 10, 20, 102—103 
declaring a message in 126 
InstaEmailViewG ontroller 103—105 

hierarchy view for the xib files 390 

HIG (Human Interface Guidelines) 
app types 48 

common issues to watch for 123 
guidelines for pickers and buttons 51 
iPad 319 

user experience (UX) considerations for the iPad 567 
HTML, UIWebYiew 588-596 



IBAction 31 ， 33—34, 39, 77-82, 105 
changing button text 19 
declaring in header file 80 
method signatures 105 
return type 128 
vs. IBOutlet 78—79 


GDB debugger 9, 291 
Geek Bits 

common warning culprits 187 
Editor Style 399 
frameworks 11 
Fugitive class 455 
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iBountyHunter app 

AppDelegate_iPhone 376, 377 
AppDelegate_Shared 377, 423 
building Captured List view 386 
building detail view 427—436 
files that you need 428 
populating view 434—435 
building Fugitive List view 382—383 
G ap ture dLis tVie wG on trailer (see 
G ap ture dListViewG on troller) 
choosing template 372 

clearing warnings in UITableViewGontroller 387 
connecting Core Data to Fugitive database 417-424 
Gore Data 
crash 452 

filtering results 477—485 
lightweight data migration 457 
mismatch between database and model 452 
requiring two models 454 
updating data 449-451 
Gore Location (see Core Location) 
creating a consistent look and feel 580-583 
creating new class for Fugitive view controller 379— 
381 

detail view 463—468 
drawing how iPhone works 376—377 
with universal app 377 
FugitiveDetailViewGontroller (see 
FugitiveDetailViewGontroller) 

Fugitive entity (see Fugitive entity) 
handling changes to data model 445-500 
iPad app design 365-367 
iPad starter code 571 
iPhone app design 368-371 
managing data (see managing data) 

Map Kit (see Map Kit) 
nib 390 

NSFetchedResultsG ontroller (see 
NSFetchedResultsG ontroller) 
object model 449 
on iPad 570 
pictures (see images) 

SourceTypePhotoLibrary 526 
SQLite database 419 
subviews 391—392 
Tab Controller view 381 
to do list 378 
UI design 463-468 


UITableViewGontroller 379, 387, 414 
wiring tab bar controller 386-387 
(see also universal apps) 

iBountyHunterAppDelegate 
checking for changes 474 
IBOutlet 19, 25-29, 31, 33-34, 39 

adding IBOutlet and property to view controller 84 

connecting picker to 86 

dealloc method 85 

getting data from picker 83-91 

New Referencing Outlet 86 

nibs 26 

@synthesize directive 85 
UITextField 102 
vs. IBAction 78-79 

ibtool 604 

icons for applications 56 
IDE 20 

iDecide app 5-40 

changing button text 19 
connecting events to methods 29 
folder 10 
logic 18 
template 11 

triggering certain events 28 
iDecideViewController 11-13, 18, 21—28, 35-37 
logic 18 

id type (Objective-G) 130 

images 502-527 

animation 504—509 
GapturedPhotoViewGontroller (see 
GapturedPhoto ViewGontroller) 
capturing HD video 521 
flipping 504 
photo library 521 
picking 511—517 

action sheets 522-527 
stuffing images in database 578 
takePictureButtonPressed action 515 
modifying 523—525 
video capture 521 
(see also camera) 

immersive apps 48-50 
implementation code 22 
ingredientsTextView 170 ， 174, 175 
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inheritance 

multiple 104 
init call after alloc 120 

InstaEmail app 

Cocoa Touch 55 

creating custom view 55 

creating new View-based project 52 

exercise solution 58 

life of root view 54-55 

making keyboard go away 122—131 

picker and button 51 

@syn the size directive 85 

UITextField (see UITextField) 

using pickers when you want controlled input 61 

view controller (see InstaEmailViewGontroller) 

InstaEmailAppDelegate 54 

InstaEmailViewGontroller 54-56, 68-72, 79—81 ， 84-90 
building view exercise 57-58 
File’s Owner 71 
.h file 103-105 

instance method 105, 130 

instance variables 
syntax for 104 
underscores after 159 

integrating iPad and iPhone UIs 371 
interface 

building in Xcode 14 
nibs 31 

Interface Builder 10, 12, 18, 20, 24, 28, 31-34, 39 
Allow Selection While Editing 306 
connecting UI controls to code 27 
hooking button to buttonPressed method 26 
(see IB Action; IBOutlet) 

interface vs. protocol 74 

internationalization 

localizing resources 602 
resources 605 
translation 604 

iOS apps 

read-only 421 
iOS devices 1 

iOS Human Interface Guide (see HIG) 


iOS SDK 4, 11 ， 20, 33—34, 612 

design patterns (see design patterns) 
downloading 6 
install directory 7 

Objective-G for iOS (see Objective-G for iOS) 
iOS Simulator 9, 33 
limitations 527 
iOS tables 171 
iPad 

building apps for iPad vs. iPhone 323 
hardware issues, iPad vs. iPhone 323 
HIG (Human Interface Guidelines) 319 
iBountyHunter 570 

iBountyHunter and iPad app design 365-367 
integrating iPad and iPhone UIs together 371 
realism 567 

user experience (UX) considerations for the iPad 567 
video support 527 

iPad Gross 357 
Solution 358 
iPad Exposed 320 
iPad HIG 359 

iPad, migrating to in DrinkMixer app 315—360 
adding split view 329—333 
App Delegate 334 
checking devices 334 

DrinkDetailViewGontroller 343—348, 351—354 
refresh View 345 

RootViewGontroller 334, 337, 344-346, 346-348 
simulator 318 
sketching for iPad 321—322 
supporting all orientations 337—360 
detail view controller 343—347 
final resources directory 340 
launch images 339—341 
persistent view problem 345 
popover 350-355 
table view 346—347 
UlPopoverController 351—353 
UI Split Vie wG ontroller 350-355 
UI Split Vie wDelegate methods 351-356 
universal app distribution xvi—xvii 
universal apps 

distribution 324-325 
using Xcode to build 326—328 
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iPad UI (see NUIs) 
iPhone 

Application Programming Guide 48 
application structure and where you can read/write 

422 

building app for iPad vs. iPhone 323 
drawing how iPhone works in iBountyHunter 376— 
377 

hardware issues, iPad vs. iPhone 323 
iBountyHunter and iPhone app design 368-371 
integrating iPad and iPhone UIs together 371 
popovers 356 
toolbox 39, 96 
video support 527 

iPhone Application Programming Guide 48 

iPhonecross 37, 92 
Solution 38, 94 
iPhoneDevcross 248 
Solution 250 

iPhone Simulator 7, 9, 11, 16— 18, 31 ， 33— 34, 39 
common issues to watch out for 17 
iterative development 568 
iTunes App Store 4, 9, 20 

K 

keyboard 

appearing 122 
changing visible area 260 
components that use 124 
covering text in DrinkMixer app 252—262 
UlScrollView 254-259 
dimensions 276 
events 276 

registering for 267—268 
state and size 269 
making keyboard go away 122—131 
notifications (see notifications) 
state and size 269 
using BOOL track 269 

Keyboard Code Magnets Part I 270—271 
Solution 274 

Keyboard Code Magnets Part II 272—273 
Solution 275 


keys 

name key 207 
key-value pairs 

dictionaries 184 



labels 171 

latitude and longitude 528-533 
launch screens before iPad 356 
lightweight automatic migration 460 

lightweight migration 499 
adding variables 460 
Link Binary With Libraries section 52 
LLVM debugger 9 
localizing nibs 602 
Location Gonstruction 531-533 

M 

MainWindow.xib 54 
malloc 120 

Managed Object Context 403, 404, 417-418, 425, 440, 
443-444, 499 

new Fugitive entity 453 
N SFetchRequest 410—411 
resetting 475 

saving new or changed items 474 
viewing fetched data 412—417 

Managed Object Model 

building Fugitive entity 399 
Gore Data Up Close 403 
creating Fugitive class 405—406 
describing entities with 398 

Managed Object Model Construction 401 
solution 402 
managing data 394—427 
Gore Data 

data types 397 

loading and saving data 396 

overview 396 

Managed Object Model (see Managed Object Model) 
NSFetchRequest 410—411 
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NSManagedObj ect 409 
viewing fetched data 412—417 

Map Kit 545-554 

annotations 553-555 

automatic NSManagedObject file generation 553 
Gore Location, difference between 547 
framework 547 
adding 548 

MKMapView 545-550 
requiring network connection 545 
simulator 545 

memory management 120,139 
larger apps 111 
(see also references) 

UITableView 155 
up close 112 

memory problems 120 

messages 127 
handling 126 
names 127 
passing 

Done button 128 
to other objects 124 
UITextField 128-129 
unknown selector 199 

MessageUI Framework 52 

methods 

arguments 130 
connecting to events 29 
declarations 105, 130 

failing to implement a required method in a protocol 
74 

implementations 128, 130 

instance 105 

names 127 

picker 76 

private 32 

signature for 128 

.m (implementation) file 10 
migrating to iPad (see iPad, migrating to) 
migration (see data migration) 
minus sign 105, 126 
MKMapView 545-550 

modal view 236—239 

navigation bar 242-246 


creating save and cancel buttons 244 
writing save and cancel buttons 245 

Model View Controller (MVG) 23, 31, 33—34 

Model-View-Controller pattern 24, 155 

multiple inheritance 104 

multiple views 171 

navigation template 146—148 
Multiple Viewscross 194 
Solution 196 
multitasking 

background time 473 
rules of engagements 473 

multi-touch 609 

pinching gesture 609 
mutable Copy 111 

N 

named arguments 127 

name field 
labels 171 
name key 207 

nameTextField 170, 174, 175 

Navigation control 
built-in apps 148 

navigation controller 148, 171， 195 
common issues to watch out for 150 
editing tables through buttons on 223—227 
maintaining stack of view controllers 180 
switching between views 179 
UIN avigationG ontroller 151 

NavigationGontrollercross 310 
Solution 312 

navigation template 146 - 148, 195 
new (creating object with) 111 
New Project 52 

New Referencing Outlet 27, 86 

nibs 10, 171 

after compilation 32 
File’s Owner 230 
graphical information 228 
hierarchy view for 390 
how nib becomes view 53—56 
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nibs (continued) 

IBOutlets 26 

Interface Builder 31,32 

loaded by framework 26 

moving into Resources group 171 

new view controller without a new nib 232 


Gore Data 

data validation 475 
hash modifier 460 

lightweight migration, renaming 460 
migration outside of 460 
NSError 475 


No Dumb Questions 56 
opening in Xcode 14 
reusing in DrinkMixer app 230 
view controller without 233 
(see also .xib files) 

nil 120 

passing messages to 125 
No Dumb Questions 

adding icons to tab bar tabs 390 

allowEditing in UllmagePickerController 527 

animation and curve properties in notification 276 

Apple’s Developer Program 527 

applicationWillTerminate 475 

apps 

configuration information 47 
controls 44 

delegate providing the content 63 
email messaging framework 44 
events 76 

failing to implement a required method in a 
protocol 74 
File’s Owner 56 
good design vs. bad design 56 
GUI builder 56 
icons 56 

interface vs. protocol 74 
layout 44 

limits to the number of protocols a class can realize 
74 

nib 56 

picker methods 76 
rebuilding for other phones 20 
starting with a sketch 44 
usability and aesthetics 47 
arrays 298 

augmented reality with the camera 527 

building apps for iPad vs. iPhone 323 

building views 20 

cancel button 291 

captured field 468 

compiler 108 

constants declared with a “k” in front of them 400 


persistence, types of 400 
SQL datatypes/table structures 400 
SQLite store 460 
unsupported type 400 
Gore Location 

and Map Kit 547 
location accuracy 542 
speeding up initial position 542 
starting and stopping 542 

waiting rather than calling back to delegate 542 
crashing apps 294 
data model versions 460 
datasource 171 

data, ways to save and load 171 

detail indicators in table view 578 

detail view 356 

devices without cameras 527 

dictionary key names 210 

doing UI after implementing functionality 578 

DrinkMixer 425 

DRY principle (Don’t Repeat Yourself) 542 

efficiency 311 

&error 475 

File’s Owner 32 

first responder to events 122 

frameworks 547 

free 120 

GDB debugger 291 

getting paths to other application directories 425 
hardware issues, iPad vs. iPhone 323 
.hfile 20 

iBountyHunter nib 390 
init call after alloc 120 

integrating iPad and iPhone UIs together 371 

Interface Builder 20, 32 

keyboard appear 122 

keyboard dimensions 276 

keyboard events 276 

labels and name field 171 

launch screens before iPad 356 

malloc 120 

Managed Object Context 425 
resetting 475 


626 Index 


the index 


memory management 120 

memory problems 120 

Navigation control and built-in apps 148 

Navigation controllers 148 

navigation template 148 

new view controller without a new nib 232 

nil 120 

nonatomic keyword 108 
notifications 266 

application going into background 294 
needing to register 294 
NSGoding 185 
NSDecimalNumber 400 

NSDictionary documentation valueForKey: and 
objectForKey 210 
NSManagedObjects 425 
NSManagedObjects, new instance 475 
NSPredicate 496 

NSSearchPathForDirectoriesInDomains 425 
number of views in tab bar 390 
Objective-G 

arguments to methods 127 
brackets for message passing 130 
constructors 120 
frameworks 20 
garbage collection 120 
id type 130 

methods and messages 127 
objects unable to respond to a message 130 
requirements 20 
selectors 130 

sending message back to sender 130 
object models 425 
outlet for save/cancel button 247 
Persistent Store Coordinator 425 
picking a fugitive without a last known location 
showing “null” 578 
popovers 356 
in iPhone 356 
private fields 234 
private interfaces 542 
private methods 32, 578 
refreshing table data 291 
registering for backgrounding notification 298 
releasing objects 120 
reloading whole table 496 
removing applications 425 
restricting the hierarchy 323 
results controller 496 


retaining objects 120 
reusing views 210 
rollback: message 475 
scroll view, manipulating 276 
SQLite store 460 
stuffing images in database 578 
subclassing 234 
switching apps 294 

switch instead of segmented control 468 
@ symbol 32, 159 
tab bar controller 

embedding navigation control in 371 
iPad 379 

table view and 379 
tables 

automatic editing support in table view 311 
cell identifier 154 
moving rows 311 
restricting row deletion 311 
section headers and footers 159 
table cell initialization code 232 
table views 

as root view 148 
customizing cells 159 
datasource and delegate 159 
plain versus grouped 159 
table cells and reusable list 154 
tabs, user switching 390 
testing camera in simulator 527 
toggle switch 379 
UISegmentGontrol 379 
UITabBarDelegate 390 
UI touches in iPad version 371 
underscores after instance variables 159 
video support 527 
view controller 171 

viewDidLoad and viewDidUnload methods 
registering and unregistering 298 
Watch it! reusing nib 232 
*.xib file, moving into Resources group 171 
Xcode 

data modeler 496 

hash modifier in Versioning Settings 460 
IDE 20 

launch orientations in 356 

size information of a control 356 

transient and indexed checkboxes 400 

nonatomic keyword 108, 109 
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Notification center exposed 264 

notifications 262, 269, 313 

animation and curve properties in 276 

application going into background 294 

can’t find list of 266 

creating own 266 

needing to register 294 

registering for events 263 

NS Array 165 

NSGF Dictionary 202 
exception 201 
NSGoding 185 
NSComparisonPredicate 479 
NSGompoundPredicate 479 
NSDecimalNumber 400 
NSDictionary 165, 184, 185 

NSDictionary documentation valueForKey: and 
objectForKey 210 

NSExpression 479 

NSFetch 

Re suits Controllers 499 
NSFetchedResultsGontroller 496 
creating new getter method 488 
monitoring for data changes 486 
multiple sections 496 
refreshing data 493 
table views 486 

updating tableview delegate and datasource 489—491 
NSFetchRequest 410—411, 496 
setting predicate on 479-483 
NSLocalizedString 605 

NSManagedObject 407, 425, 440, 443, 450, 460, 474 
new instance 475 
properties 409 

N SMu table Array 159 
NSMutableDictionary 278, 281, 291, 307 
NSNotificationGenter 262-263, 267-268, 296 

NSPredicate 478-481,488 
conditions 496 
full syntax for 496 

NSSearchPathForDirectoriesInDomains 425 


NSSortDescriptor 292 
NS String 

assign property for 110 
building email with strings 134 
@ symbol 32, 159 
with the title for given row 72 

NS Strings 69 

NUI cross 598 
Solution 600 

NUIs (natural user interfaces) 563—600 
about 566 

iterative development 568 
Toolboxes 599 

NullPointerExceptions 125 

numberOfGomponentsInPickerView:pickerView method 
70 

0 

objectAtlndex message 124 
Objective-G 

arguments to methods 127 
brackets for message passing 130 
constructors 120 
garbage collection 120 
id type 130 

libraries (see frameworks) 

method arguments 130 

method declarations 130 

method implementations 130 

methods and messages 127 

objects unable to respond to a message 130 

private framework headers 130 

requirements 20 

selectors 130 

sending message back to sender 130 
send messages to receivers 130 
toolbox 139 
UI behavior 18 
UlWebView 588-596 

Objective-G cross 138 
Solution 140 
Objective-G Exposed 119 
Objective-G for iOS 99—140 
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object models 425, 449 
objects 

retaining and releasing 120 
unable to respond to a message 130 

Objects Library 13 

OpenGL 610 

orientations (see iPad, migrating to in DrinkMixer app) 
outlets 77 

connecting picker to IBOutlet 86 
connecting to detail view 175 
declarations 84 
New Referencing Outlet 86 

P 

paths, getting to other application directories 425 
patterns (see design patterns) 
persistence, types of 400 

Persistent Object Store 403, 418-419, 425, 453-456, 

459, 499 

Exposed 459 

Persistent Store Coordinator 403, 418, 419, 425, 453 

photo library 521 

picking image from 522 
photos (see images) 
pickers 74, 96 

connecting picker to IBOutlet 86 
data 60 

controlled input 61 
datasource 62, 65—66 
delegates 65-66 
Exposed 64-65 

getting data from picker using IBOutlet 83-91 
HIG guidelines 51 
methods 76 

using reference to pull selected values 87 
pickerView:numberOfRowsInGomponent method 67, 70 
pickerView:titleForRow:forGomponent method 67, 72 
pictures (see images) 
plists 195 

Anatomy of a Crash 199 
arrays 165 
built-in types 163 
code used to save 295 


code used to save plist 421 
creating empty 163—164 
dictionaries 203—204 
DrinkMixer app 162—166 
DrinksDirections 185 
formatting and populating 163-164 
problem with 397 

pointer types 104 

popovers 350-356 
in iPhone 356 
predicates 478 

NSPredicate (see NSPredicate) 
setting on NSFetchRequest 479-483 

prepareFugitiveDescription 573-575 

prepareMapDescription 573-575 

private fields 234 

private framework headers 130 

private interfaces 542 

private methods 32 

productivity apps 48—50, 171 

DrinkMixer (see DrinkMixer app) 
protocols 96 

angle brackets 104 
datasource 67—74 

adding implementation code 68-69 

declaring controller conforms to both protocols 68 

required methods 70 

limits to the number of protocols a class can realize 
74 

Provisioning Profile 612 

Quartz 610 

R 

readonly 108, 109， 139 
re ad write 108, 139 
Ready Bake Code 

G ap ture dPho to Vie wG ontroller. m 512 
DrinksDirections.plist 185 
iBountyHunter iPad starter code 571 
messaging API 89—90 
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Ready Bake plist 165 
realism 567 

refactoring code 589-592 

references 

counting 109 

determining how many left 113—115 
registering for events 263 
releasing objects 120 
restricting the hierarchy 323 
results controller 496 
retain 108-109, 139 
retaining objects 120 
Return Key popup menu 123 
return type 128 
rollback: message 475 

root view 

life of 54-55 
table view as 148 

RootViewGontroller 334, 337, 344, 346—347 
debugging 285-286 
DrinkMixer app 156—157 
saving array 295—296 
saving new drinks 279—281 
UITable View 151 



scroll view 254—262, 313 
manipulating 276 
subviews 254 
vs. content view 260 

SDK (see iOS SDK) 

section headers and footers 159 

selectedRowInGomponent: method 87 

selectors 130 
unknown 199 

sendButtonTapped 103, 105, 125-126, 128, 135-136 

sendButtonTapped method 87 

setter method 106, 107, 108, 109 ， 119， 139 


showFugitiveDossier 573-575 

simulator 7, 9 ， 10, 33 
blue guide lines 58 
camera 518, 527 
code used to save plist 295 
directory permissions 425 
InstaEmail 58, 59, 118 
iPad 317-318 
selecting 317 
iPhone 6, 31 
limitations 17 
Map Kit 545 
rotating 355 

uninstalling old version of app from 424 
vs. actual devices 120 
when app crashes in 187 
Xcode’s debugging pane 188 

sketches 568 
sorting 313 
sorting array 292 
SourceTypePhotoLibrary 526 

split-view controller 359 
BountyHunterHD 570 
Split-view Magnets 329 
Solution 330—333 
SQL datatypes/table structures 400 

SQLite database 

and automatic migration 460 
iBountyHunter 419 

SQLite store 

Gore Data and optimizing migration 460 
static method 130 
strings 

building email with 134 
strings files 604 
strongly typed data 397 
subclassing 234 

subviews 391—392 
scroll view 254 
switching tabs 390 
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T 

tab bar 

number of views 390 
tab bar controller 361 

embedding navigation control 371 
iPad 379 

table view and 379 
Tab Bar Up Close 368 
Tab Controller view 381 
Table Cell Code Up 153 
table cell initialization code 232 

Table Cell Magnets 413 
Solution 416 
Table Cells Up Close 214 

tables 171, 195 

arrays (see arrays) 

automatic editing support in table view 311 
cells 

identifier 154 
populating 154-158 
reusable list 154 
customizing 152 

editing through buttons on controller 223—227 

memory management 155 

moving rows 311 

N SMu table Array 159 

refreshing table data 291 

restricting row deletion 311 

section headers and footers 159 

Table Cell Code Up 153 

UITableView (see UITableView) 

tablet computing 566 

table view 171 

as root view 148 
customizing cells 159 
datasource 152, 159 
delegates 152 
editing 313 

editing and deleting data 300-307 
iPad, migrating to in DrinkMixer app 346—347 
navigation template 146—148 
NSFetchedResultsGontrollers 486 
plain versus grouped 159 


reloading 288 
sorting array 292 
standard pattern 168 
switching between views 179 
templates 152 

UIN avigationG ontroller 151 
UITableView (see UITableView) 
up close 151 

tabs, switching 390 

takePictureButtonPressed action 515 
modifying 523—525 
targets 327 
templates 9 

choosing template for iBountyHunter 372 

Create Local Git Repository 8 

datasource 152 

delegates 152 

Device Family 8 

iDecide 11 

Include Unit Tests 8 

multiple views 146 

navigation 146 — 147 

Product Name 8 

table views 152 

theme 580-583 

Toggle Code Magnets 469 
Solution 470 
toggle switch 379 
toolbar 11 

Toolboxes 

Core Data 444 
data 499 
iOS 195, 249 

iOS Development 313, 359 
iPhone 39, 96 
Location 561 
NUIs 599 
Objective-G 139 

translating text in an app 604 

tree diagram style 399 

tutorials 48 

types 104 
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TJ 

UIApplicationDelegate 54 
UIApplicationDidEnterBackground 294 
UIApplicationDidEnterBackgroundNotification 295, 296 
UIApplicationMain 54 

UI Design Magnets 143 
Solution 144 

UIImagePickerGontroller 511—515, 521—526 
allowEditing 527 
checking specific capabilities 521 

UIKeyboardDidHideNotification 267-269, 275 

UIKeyboardDidShowNotification 262—263, 267—269, 
276 

UIKit 11,21-22, 504 

UIModalTransitionStyleFlipHorizontal 505, 507, 516 

UIN avigationG ontroller 151 

UlPickerView 

selectedRowInGomponent: method 87 
UIPickerViewDataSource 62, 102—104, 127 
protocol 67 

required methods 70 

UIPickerViewDelegate 7 2 
UIPopoverGontroller 351—353 
UIs 

behavior 18 
components 26 

triggering events 28 
connecting UI controls to code 27 
detail view in iBountyHunter 463—468 
doing UI after implementing functionality 578 
Geek Bits 432 

integrating iPad and iPhone UIs together 371 

iPad (see NUIs) 

iterative development 568 

NUIs (see NUIs) 

separating from behavior 229 

sketching DrinkMixer app for iPad 321—322 

theme 580-583 

universal apps 364 

UlScrollView 254-259 
contentSize 257-258 


Easy GUI REGonstruction 256 
wrapping content in 255 

UlScrollView Up 254 

UISegmentGontrol 379 

UISplitViewGontroller 350-355 

UISplitViewDelegate methods 351-356 

UITabBarDelegate 390 

UITableView 151-157, 181 
memory management 155 
NSFetchedResultsGontroller 486 
reusing cells 155 
RootViewG ontroller 151 

UITableViewGontroller 379, 387, 414 
clearing warnings 387 
DrinkMixer app 156 

UITextField 102-107, 116-117 
components and 124 
connecting to event 129 
customizing 123 
disabling 176 
Geek Bits 129 
giving up focus 125 
IBOutlet 102 

list of events UITextField can send 129 
message passing 128-129 
send email button 133—137 
send message button 134 

UITextView 
disabling 176 
UlWebView 585-587 
vs. UlWebView 586-587 

UI touches in iPad version 371 
UIViewG ontroller 54 

UlWebView 599 

Formatting Text Up Close 595 
HTML, CSS and Objective-G 588-596 
options 586-587 
vs. UITextView 586—587 

underscores after instance variables 159 
undocumented APIs 32 

universal apps 359, 364 
App Store 364 
device checking 364 
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drawing how iBountyHunter works 377 
structure 374 
UIs 364 

Universal App Distribution, pros and cons xvi—xvii, 
324—325 

using Xcode to build 326—328 
unknown selector 199 
unregistering 263 
updateDossier 573-575 
usability 47 

user experience (UX) considerations for the iPad 567 
Utilities Pane 13 
utility apps 48—50 

V 

variables 

underscores after instance variables 159 
video capture 521 
video support 527 

View-based Application 
InstaEmail 52 

view controllers 24, 171, 229 
instantiating 181 
maintaining stack of 180 
making keyboard go away 122—131 
new view controller without a new nib 232 
subclassing and extending 231 
views connected to code through 31 
without nib 233 

viewDidLoad 125 

registering and unregistering 298 
views 249 

adding buttons 15 
building 20 

connected to code through view controller 31 
detail (see detail views) 
modal (see modal views) 
multiple 

navigation template 148 
root (see root view) 

View-ViewGontroller pattern 24 

viewWillAppear 263, 298, 412, 415, 433, 435, 496 

viewWillDisappear 263, 298 


¥ 

Watch it! 

Apple’s new devices and updating capabilities 520 
automatic NSManagedObject file generation 553 
code used to save plist 295, 421 
Gore Location and battery life 537 
HIG 123 

iPads vs. iPhones 564 

keyboard notification 269 

Map Kit requiring network connection 545 

Navigation controller 150 

new project type in Xcode 52 

nil 

passing messages to 125 
object model 400 
private framework headers 130 
reusing nib 230, 232 
Simulator 17 

stopping and hitting u Build and Debug” in Xcode 
297 

uneditable fields 239 

uninstalling old version of your app 424 

wire-frames 568 

wrapping objects. See Adapter Pattern, Decorator 
Pattern, Facade Pattern 

X 

Xcode 4-14, 195 

as hub of iOS project 10—11 
building interface in 14 
Bullet Points 31 
data modeler 496 
debugging 189 
breakpoints 190 
debuggers 9 
debugging pane 188 
state of application 191 
editing view files 13 
functions 33—34 

hash modifier in Versioning Settings 460 
IDE 9, 20 

launch orientations in 356 
new project type in 52 
Organizer 614 

size information of a control 356 
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Xcode (continued) 
starting 8 

stopping and hitting “Build and Debug” in 
templates 8, 9 

transient and indexed checkboxes 400 
using to build universal app 326—328 
XML descriptions of view (see nib) 

Xcode Files Up Close 12 

Xcode Magnets 135 
Solution 136 
Xcode Organizer 614 
•xib files (see nibs) 

XML descriptions of view (see nib) 
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